Int64 結構

定義

命名空間:

System

組件:

System.Runtime.dll

Source:

Int64.cs

表示 64 位元帶正負號的整數。

public value class long : IComparable<long>, IConvertible, IEquatable<long>, IParsable<long>, ISpanParsable<long>, IUtf8SpanParsable<long>, System::Numerics::IAdditionOperators<long, long, long>, System::Numerics::IAdditiveIdentity<long, long>, System::Numerics::IBinaryInteger<long>, System::Numerics::IBinaryNumber<long>, System::Numerics::IBitwiseOperators<long, long, long>, System::Numerics::IComparisonOperators<long, long, bool>, System::Numerics::IDecrementOperators<long>, System::Numerics::IDivisionOperators<long, long, long>, System::Numerics::IEqualityOperators<long, long, bool>, System::Numerics::IIncrementOperators<long>, System::Numerics::IMinMaxValue<long>, System::Numerics::IModulusOperators<long, long, long>, System::Numerics::IMultiplicativeIdentity<long, long>, System::Numerics::IMultiplyOperators<long, long, long>, System::Numerics::INumber<long>, System::Numerics::INumberBase<long>, System::Numerics::IShiftOperators<long, int, long>, System::Numerics::ISignedNumber<long>, System::Numerics::ISubtractionOperators<long, long, long>, System::Numerics::IUnaryNegationOperators<long, long>, System::Numerics::IUnaryPlusOperators<long, long>

public readonly struct Int64 : IComparable<long>, IConvertible, IEquatable<long>, IParsable<long>, ISpanParsable<long>, IUtf8SpanParsable<long>, System.Numerics.IAdditionOperators<long,long,long>, System.Numerics.IAdditiveIdentity<long,long>, System.Numerics.IBinaryInteger<long>, System.Numerics.IBinaryNumber<long>, System.Numerics.IBitwiseOperators<long,long,long>, System.Numerics.IComparisonOperators<long,long,bool>, System.Numerics.IDecrementOperators<long>, System.Numerics.IDivisionOperators<long,long,long>, System.Numerics.IEqualityOperators<long,long,bool>, System.Numerics.IIncrementOperators<long>, System.Numerics.IMinMaxValue<long>, System.Numerics.IModulusOperators<long,long,long>, System.Numerics.IMultiplicativeIdentity<long,long>, System.Numerics.IMultiplyOperators<long,long,long>, System.Numerics.INumber<long>, System.Numerics.INumberBase<long>, System.Numerics.IShiftOperators<long,int,long>, System.Numerics.ISignedNumber<long>, System.Numerics.ISubtractionOperators<long,long,long>, System.Numerics.IUnaryNegationOperators<long,long>, System.Numerics.IUnaryPlusOperators<long,long>

type int64 = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<int64>
    interface ISpanFormattable
    interface ISpanParsable<int64>
    interface IAdditionOperators<int64, int64, int64>
    interface IAdditiveIdentity<int64, int64>
    interface IBinaryInteger<int64>
    interface IBinaryNumber<int64>
    interface IBitwiseOperators<int64, int64, int64>
    interface IComparisonOperators<int64, int64, bool>
    interface IEqualityOperators<int64, int64, bool>
    interface IDecrementOperators<int64>
    interface IDivisionOperators<int64, int64, int64>
    interface IIncrementOperators<int64>
    interface IModulusOperators<int64, int64, int64>
    interface IMultiplicativeIdentity<int64, int64>
    interface IMultiplyOperators<int64, int64, int64>
    interface INumber<int64>
    interface INumberBase<int64>
    interface ISubtractionOperators<int64, int64, int64>
    interface IUnaryNegationOperators<int64, int64>
    interface IUnaryPlusOperators<int64, int64>
    interface IUtf8SpanFormattable
    interface IUtf8SpanParsable<int64>
    interface IShiftOperators<int64, int, int64>
    interface IMinMaxValue<int64>
    interface ISignedNumber<int64>

Public Structure Int64
Implements IAdditionOperators(Of Long, Long, Long), IAdditiveIdentity(Of Long, Long), IBinaryInteger(Of Long), IBinaryNumber(Of Long), IBitwiseOperators(Of Long, Long, Long), IComparable(Of Long), IComparisonOperators(Of Long, Long, Boolean), IConvertible, IDecrementOperators(Of Long), IDivisionOperators(Of Long, Long, Long), IEqualityOperators(Of Long, Long, Boolean), IEquatable(Of Long), IIncrementOperators(Of Long), IMinMaxValue(Of Long), IModulusOperators(Of Long, Long, Long), IMultiplicativeIdentity(Of Long, Long), IMultiplyOperators(Of Long, Long, Long), INumber(Of Long), INumberBase(Of Long), IParsable(Of Long), IShiftOperators(Of Long, Integer, Long), ISignedNumber(Of Long), ISpanParsable(Of Long), ISubtractionOperators(Of Long, Long, Long), IUnaryNegationOperators(Of Long, Long), IUnaryPlusOperators(Of Long, Long), IUtf8SpanParsable(Of Long)

繼承

Object

ValueType

Int64

實作

IComparable IComparable<Int64> IConvertible IEquatable<Int64> IFormattable ISpanFormattable IComparable<TSelf> IEquatable<TSelf> IParsable<Int64> IParsable<TSelf> ISpanParsable<Int64> ISpanParsable<TSelf> IAdditionOperators<Int64,Int64,Int64> IAdditionOperators<TSelf,TSelf,TSelf> IAdditiveIdentity<Int64,Int64> IAdditiveIdentity<TSelf,TSelf> IBinaryInteger<Int64> IBinaryNumber<Int64> IBinaryNumber<TSelf> IBitwiseOperators<Int64,Int64,Int64> IBitwiseOperators<TSelf,TSelf,TSelf> IComparisonOperators<Int64,Int64,Boolean> IComparisonOperators<TSelf,TSelf,Boolean> IDecrementOperators<Int64> IDecrementOperators<TSelf> IDivisionOperators<Int64,Int64,Int64> IDivisionOperators<TSelf,TSelf,TSelf> IEqualityOperators<Int64,Int64,Boolean> IEqualityOperators<TSelf,TOther,TResult> IEqualityOperators<TSelf,TSelf,Boolean> IIncrementOperators<Int64> IIncrementOperators<TSelf> IMinMaxValue<Int64> IModulusOperators<Int64,Int64,Int64> IModulusOperators<TSelf,TSelf,TSelf> IMultiplicativeIdentity<Int64,Int64> IMultiplicativeIdentity<TSelf,TSelf> IMultiplyOperators<Int64,Int64,Int64> IMultiplyOperators<TSelf,TSelf,TSelf> INumber<Int64> INumber<TSelf> INumberBase<Int64> INumberBase<TSelf> IShiftOperators<Int64,Int32,Int64> IShiftOperators<TSelf,Int32,TSelf> ISignedNumber<Int64> ISubtractionOperators<Int64,Int64,Int64> ISubtractionOperators<TSelf,TSelf,TSelf> IUnaryNegationOperators<Int64,Int64> IUnaryNegationOperators<TSelf,TSelf> IUnaryPlusOperators<Int64,Int64> IUnaryPlusOperators<TSelf,TSelf> IUtf8SpanFormattable IUtf8SpanParsable<Int64> IUtf8SpanParsable<TSelf>

備註

如需此 API 的詳細資訊，請參閱 Int64 補充 API 備註。

欄位

MaxValue	代表 Int64 最大的可能值。 這個欄位為常數。
MinValue	代表 Int64 的最小可能值。 這個欄位為常數。

方法

Abs(Int64)	計算值的絕對值。
Clamp(Int64, Int64, Int64)	將值限製為內含最小值和最大值。
CompareTo(Int64)	將這個執行個體與指定的 64 元帶正負號的整數相比較，並傳回它們的相對值指示。
CompareTo(Object)	將這個執行個體與指定的物件相比較，並傳回它們的相對值指示。
CopySign(Int64, Int64)	將值的正負號複製到另一個值的正負號。
CreateChecked<TOther>(TOther)	從值建立目前型別的實例，針對落在目前類型可表示範圍以外的任何值擲回溢位例外狀況。
CreateSaturating<TOther>(TOther)	從值建立目前型別的實例，使落在目前類型可表示範圍以外的任何值飽和。
CreateTruncating<TOther>(TOther)	從值建立目前型別的實例，截斷落在目前類型可表示範圍以外的任何值。
DivRem(Int64, Int64)	計算兩個值的商數和餘數。
Equals(Int64)	傳回值，表示這個執行個體是否等於指定的 Int64 值。
Equals(Object)	傳回值，該值表示這個執行個體是否和指定的物件相等。
GetHashCode()	傳回這個執行個體的雜湊碼。
GetTypeCode()	傳回實值類型 TypeCode 的 Int64。
IsEvenInteger(Int64)	判斷值是否代表偶數整數。
IsNegative(Int64)	判斷值是否為負值。
IsOddInteger(Int64)	判斷值是否代表奇數整數。
IsPositive(Int64)	判斷值是否為正數。
IsPow2(Int64)	判斷值是否為兩個的乘冪。
LeadingZeroCount(Int64)	計算值中的前置零數目。
Log2(Int64)	計算值的log2。
Max(Int64, Int64)	比較兩個值與大於的計算。
MaxMagnitude(Int64, Int64)	比較兩個值與大於的計算。
Min(Int64, Int64)	比較兩個值與比較較少的計算。
MinMagnitude(Int64, Int64)	比較兩個值與比較較少的計算。
Parse(ReadOnlySpan<Byte>, IFormatProvider)	將UTF-8字元的範圍剖析為值。
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	將UTF-8字元的範圍剖析為值。
Parse(ReadOnlySpan<Char>, IFormatProvider)	將字元範圍剖析為值。
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等 64 位元帶正負號的整數。
Parse(String)	將數字的字串表示轉換成它的對等 64 位元帶正負號的整數。
Parse(String, IFormatProvider)	將指定特定文化特性格式之數字的字串表示轉換成它的對等 64 位元帶正負號的整數。
Parse(String, NumberStyles)	將指定樣式之數字的字串表示轉換成它的對等 64 位元帶正負號的整數。
Parse(String, NumberStyles, IFormatProvider)	將指定樣式和特定文化特性格式之數字的字串表示轉換成它的對等 64 位元帶正負號的整數。
PopCount(Int64)	計算值中所設定的位數。
RotateLeft(Int64, Int32)	旋轉指定數量所留下的值。
RotateRight(Int64, Int32)	以指定的數量向右旋轉值。
Sign(Int64)	計算值的符號。
ToString()	將這個執行個體的數值轉換為其相等字串表示。
ToString(IFormatProvider)	使用指定的特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String)	使用指定格式，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String, IFormatProvider)	使用指定的格式和特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。
TrailingZeroCount(Int64)	計算值中尾端零的數目。
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前實例的值格式化為UTF-8到提供的位元組範圍。
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前長整數執行個體的值格式化為所提供的字元範圍。
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Int64)	嘗試將UTF-8字元的範圍剖析為值。
TryParse(ReadOnlySpan<Byte>, Int64)	嘗試將包含數位字串表示的UTF-8字元範圍轉換為其對等的64位帶正負號的整數。
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Int64)	嘗試將UTF-8字元的範圍剖析為值。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Int64)	嘗試將字元範圍剖析為值。
TryParse(ReadOnlySpan<Char>, Int64)	將數字的範圍表示轉換為其對等 64 位元帶正負號的整數。 傳回值，該值指出轉換成功或失敗。
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Int64)	將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等 64 位元帶正負號的整數。 傳回值，該值指出轉換成功或失敗。
TryParse(String, IFormatProvider, Int64)	嘗試將字串剖析成值。
TryParse(String, Int64)	將數字的字串表示轉換成它的對等 64 位元帶正負號的整數。 傳回值，該值指出轉換成功或失敗。
TryParse(String, NumberStyles, IFormatProvider, Int64)	將指定樣式和特定文化特性格式之數字的字串表示轉換成它的對等 64 位元帶正負號的整數。 傳回值，該值指出轉換成功或失敗。

明確介面實作

IAdditionOperators<Int64,Int64,Int64>.Addition(Int64, Int64)	將兩個值加在一起，以計算其總和。
IAdditionOperators<Int64,Int64,Int64>.CheckedAddition(Int64, Int64)	將兩個值加在一起，以計算其總和。
IAdditiveIdentity<Int64,Int64>.AdditiveIdentity	取得目前類型的加法識別。
IBinaryInteger<Int64>.GetByteCount()	取得將寫入為的 TryWriteLittleEndian(Span<Byte>, Int32)位元元組數目。
IBinaryInteger<Int64>.GetShortestBitLength()	取得目前值之最短兩個補碼表示法的長度，以位為單位。
IBinaryInteger<Int64>.TryReadBigEndian(ReadOnlySpan<Byte>, Boolean, Int64)	表示 64 位元帶正負號的整數。
IBinaryInteger<Int64>.TryReadLittleEndian(ReadOnlySpan<Byte>, Boolean, Int64)	表示 64 位元帶正負號的整數。
IBinaryInteger<Int64>.TryWriteBigEndian(Span<Byte>, Int32)	嘗試將目前值以大端格式寫入指定的範圍。
IBinaryInteger<Int64>.TryWriteLittleEndian(Span<Byte>, Int32)	嘗試將目前值以小到尾格式寫入指定的範圍。
IBinaryNumber<Int64>.AllBitsSet	取得二進位類型的實例，其中已設定所有位。
IBitwiseOperators<Int64,Int64,Int64>.BitwiseAnd(Int64, Int64)	計算兩個值的位和 。
IBitwiseOperators<Int64,Int64,Int64>.BitwiseOr(Int64, Int64)	計算兩個值的位或兩個值。
IBitwiseOperators<Int64,Int64,Int64>.ExclusiveOr(Int64, Int64)	計算兩個值的獨佔或兩個值。
IBitwiseOperators<Int64,Int64,Int64>.OnesComplement(Int64)	計算指定值的 ones-補碼表示法。
IComparisonOperators<Int64,Int64,Boolean>.GreaterThan(Int64, Int64)	比較兩個值，以判斷哪一個值更大。
IComparisonOperators<Int64,Int64,Boolean>.GreaterThanOrEqual(Int64, Int64)	比較兩個值，以判斷哪一個值大於或相等。
IComparisonOperators<Int64,Int64,Boolean>.LessThan(Int64, Int64)	比較兩個值，以判斷哪一個值較少。
IComparisonOperators<Int64,Int64,Boolean>.LessThanOrEqual(Int64, Int64)	比較兩個值，以判斷哪一個值小於或相等。
IConvertible.ToBoolean(IFormatProvider)	如需這個成員的說明，請參閱 ToBoolean(IFormatProvider)。
IConvertible.ToByte(IFormatProvider)	如需這個成員的說明，請參閱 ToByte(IFormatProvider)。
IConvertible.ToChar(IFormatProvider)	如需這個成員的說明，請參閱 ToChar(IFormatProvider)。
IConvertible.ToDateTime(IFormatProvider)	不支援此轉換。 嘗試使用這個方法會擲回 InvalidCastException。
IConvertible.ToDecimal(IFormatProvider)	如需這個成員的說明，請參閱 ToDecimal(IFormatProvider)。
IConvertible.ToDouble(IFormatProvider)	如需這個成員的說明，請參閱 ToDouble(IFormatProvider)。
IConvertible.ToInt16(IFormatProvider)	如需這個成員的說明，請參閱 ToInt16(IFormatProvider)。
IConvertible.ToInt32(IFormatProvider)	如需這個成員的說明，請參閱 ToInt32(IFormatProvider)。
IConvertible.ToInt64(IFormatProvider)	如需這個成員的說明，請參閱 ToInt64(IFormatProvider)。
IConvertible.ToSByte(IFormatProvider)	如需這個成員的說明，請參閱 ToSByte(IFormatProvider)。
IConvertible.ToSingle(IFormatProvider)	如需這個成員的說明，請參閱 ToSingle(IFormatProvider)。
IConvertible.ToType(Type, IFormatProvider)	如需這個成員的說明，請參閱 ToType(Type, IFormatProvider)。
IConvertible.ToUInt16(IFormatProvider)	如需這個成員的說明，請參閱 ToUInt16(IFormatProvider)。
IConvertible.ToUInt32(IFormatProvider)	如需這個成員的說明，請參閱 ToUInt32(IFormatProvider)。
IConvertible.ToUInt64(IFormatProvider)	如需這個成員的說明，請參閱 ToUInt64(IFormatProvider)。
IDecrementOperators<Int64>.CheckedDecrement(Int64)	遞減值。
IDecrementOperators<Int64>.Decrement(Int64)	遞減值。
IDivisionOperators<Int64,Int64,Int64>.Division(Int64, Int64)	將一個值除以計算其商數。
IEqualityOperators<Int64,Int64,Boolean>.Equality(Int64, Int64)	比較兩個值來判斷相等。
IEqualityOperators<Int64,Int64,Boolean>.Inequality(Int64, Int64)	比較兩個值來判斷不相等。
IIncrementOperators<Int64>.CheckedIncrement(Int64)	遞增值。
IIncrementOperators<Int64>.Increment(Int64)	遞增值。
IMinMaxValue<Int64>.MaxValue	取得目前型別的最大值。
IMinMaxValue<Int64>.MinValue	取得目前型別的最小值。
IModulusOperators<Int64,Int64,Int64>.Modulus(Int64, Int64)	將兩個值分割在一起，以計算其模數或餘數。
IMultiplicativeIdentity<Int64,Int64>.MultiplicativeIdentity	取得目前型別的乘法識別。
IMultiplyOperators<Int64,Int64,Int64>.CheckedMultiply(Int64, Int64)	將兩個值相乘以計算其產品。
IMultiplyOperators<Int64,Int64,Int64>.Multiply(Int64, Int64)	將兩個值相乘以計算其產品。
INumber<Int64>.MaxNumber(Int64, Int64)	比較兩個值與計算，如果輸入為 NaN，則會傳回另一個值。
INumber<Int64>.MinNumber(Int64, Int64)	比較兩個值與計算，如果輸入為 NaN，則會傳回另一個值。
INumberBase<Int64>.IsCanonical(Int64)	判斷值是否在其標準表示中。
INumberBase<Int64>.IsComplexNumber(Int64)	判斷值是否代表複數。
INumberBase<Int64>.IsFinite(Int64)	判斷值是否有限。
INumberBase<Int64>.IsImaginaryNumber(Int64)	判斷值是否代表純虛數。
INumberBase<Int64>.IsInfinity(Int64)	判斷值是否為無限。
INumberBase<Int64>.IsInteger(Int64)	判斷值是否代表整數。
INumberBase<Int64>.IsNaN(Int64)	判斷值是否為 NaN。
INumberBase<Int64>.IsNegativeInfinity(Int64)	判斷值是否為負無限大。
INumberBase<Int64>.IsNormal(Int64)	判斷值是否正常。
INumberBase<Int64>.IsPositiveInfinity(Int64)	判斷值是否為正無限大。
INumberBase<Int64>.IsRealNumber(Int64)	判斷值是否代表實數。
INumberBase<Int64>.IsSubnormal(Int64)	判斷值是否為次正常。
INumberBase<Int64>.IsZero(Int64)	判斷值是否為零。
INumberBase<Int64>.MaxMagnitudeNumber(Int64, Int64)	比較兩個值與具有較大大小的計算，如果輸入為 NaN，則會傳回另一個值。
INumberBase<Int64>.MinMagnitudeNumber(Int64, Int64)	比較兩個值與計算，其大小較小，如果輸入為 NaN，則會傳回另一個值。
INumberBase<Int64>.One	取得型別的值 1 。
INumberBase<Int64>.Radix	取得類型的基數或基底。
INumberBase<Int64>.TryConvertFromChecked<TOther>(TOther, Int64)	表示 64 位元帶正負號的整數。
INumberBase<Int64>.TryConvertFromSaturating<TOther>(TOther, Int64)	表示 64 位元帶正負號的整數。
INumberBase<Int64>.TryConvertFromTruncating<TOther>(TOther, Int64)	表示 64 位元帶正負號的整數。
INumberBase<Int64>.TryConvertToChecked<TOther>(Int64, TOther)	嘗試將目前類型的實例轉換成另一個類型，針對落在目前類型可表示範圍以外的任何值擲回溢位例外狀況。
INumberBase<Int64>.TryConvertToSaturating<TOther>(Int64, TOther)	嘗試將目前類型的實例轉換成另一種類型，使落在目前類型可表示範圍以外的任何值飽和。
INumberBase<Int64>.TryConvertToTruncating<TOther>(Int64, TOther)	嘗試將目前類型的實例轉換成另一個類型，截斷落在目前類型可表示範圍以外的任何值。
INumberBase<Int64>.Zero	取得型別的值 0 。
IShiftOperators<Int64,Int32,Int64>.LeftShift(Int64, Int32)	將值左移指定的數量。
IShiftOperators<Int64,Int32,Int64>.RightShift(Int64, Int32)	以指定的數量向右移值。
IShiftOperators<Int64,Int32,Int64>.UnsignedRightShift(Int64, Int32)	以指定的數量向右移值。
ISignedNumber<Int64>.NegativeOne	取得型別的值 -1 。
ISubtractionOperators<Int64,Int64,Int64>.CheckedSubtraction(Int64, Int64)	減去兩個值來計算其差異。
ISubtractionOperators<Int64,Int64,Int64>.Subtraction(Int64, Int64)	減去兩個值來計算其差異。
IUnaryNegationOperators<Int64,Int64>.CheckedUnaryNegation(Int64)	計算值的已檢查一元否定。
IUnaryNegationOperators<Int64,Int64>.UnaryNegation(Int64)	計算值的一元負數。
IUnaryPlusOperators<Int64,Int64>.UnaryPlus(Int64)	計算值的一元加號。

執行緒安全性

此類型的所有成員都是安全線程。 看似修改實例狀態的成員，實際上會傳回以新值初始化的新實例。 如同任何其他類型，讀取和寫入包含此類型實例的共用變數必須受到鎖定保護，以確保線程安全。

另請參閱

• UInt64
• Sample: .NET Core WinForms Formatting Utility (C#) (範例：.NET Core WinForms 格式化公用程式 (C#))
• Sample: .NET Core WinForms Formatting Utility (Visual Basic) (範例：.NET Core WinForms 格式化公用程式 (Visual Basic))