UInt64 UInt64 UInt64 UInt64 Struct

定義

重要

此 API 不符合 CLS 規範。

表示 64 位元不帶正負號的整數 (Unsigned Integer)。Represents a 64-bit unsigned integer.

public value class UInt64 : IComparable, IComparable<System::UInt64>, IConvertible, IEquatable<System::UInt64>, IFormattable
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct UInt64 : IComparable, IComparable<ulong>, IConvertible, IEquatable<ulong>, IFormattable
type uint64 = struct
    interface IFormattable
    interface IConvertible
Public Structure UInt64
Implements IComparable, IComparable(Of ULong), IConvertible, IEquatable(Of ULong), IFormattable
繼承
屬性
實作

備註

UInt64實值型別代表不帶正負號的整數值範圍從 0 到 18446744073709551615。The UInt64 value type represents unsigned integers with values ranging from 0 to 18,446,744,073,709,551,615.

重要

UInt64類型不符合 CLS 標準。The UInt64 type is not CLS-compliant. 符合 CLS 規範替代型別是DecimalThe CLS-compliant alternative type is Decimal. Int64 可以改為用來取代UInt64值,範圍從 0 到MaxValueInt64 can be used instead to replace a UInt64 value that ranges from zero to MaxValue. 如需 CLS 合規性的詳細資訊,請參閱Language Independence and Language-independent ComponentsFor more information about CLS compliance, see Language Independence and Language-Independent Components.

UInt64 提供方法來比較此類型的執行個體、 執行個體的值轉換成其字串表示,並將數字的字串表示轉換成此型別的執行個體。UInt64 provides methods to compare instances of this type, convert the value of an instance to its string representation, and convert the string representation of a number to an instance of this type.

欄位

MaxValue MaxValue MaxValue MaxValue

代表 UInt64 最大的可能值。Represents the largest possible value of UInt64. 這個欄位是常數。This field is constant.

MinValue MinValue MinValue MinValue

代表 UInt64 最小的可能值。Represents the smallest possible value of UInt64. 這個欄位是常數。This field is constant.

方法

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

將這個執行個體與指定的物件相比較,並傳回它們的相對值指示。Compares this instance to a specified object and returns an indication of their relative values.

CompareTo(UInt64) CompareTo(UInt64) CompareTo(UInt64) CompareTo(UInt64)

將這個執行個體與指定的 64 位元不帶正負號的整數相比較,並傳回它們的相對值指示。Compares this instance to a specified 64-bit unsigned integer and returns an indication of their relative values.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

傳回值,指出這個執行個體 (Instance) 是否和指定的物件相等。Returns a value indicating whether this instance is equal to a specified object.

Equals(UInt64) Equals(UInt64) Equals(UInt64) Equals(UInt64)

傳回值,表示這個執行個體是否等於指定的 UInt64 值。Returns a value indicating whether this instance is equal to a specified UInt64 value.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

傳回這個執行個體的雜湊碼。Returns the hash code for this instance.

GetTypeCode() GetTypeCode() GetTypeCode() GetTypeCode()

傳回實值類型 TypeCodeUInt64Returns the TypeCode for value type UInt64.

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

將指定樣式和特定文化特性格式之數字的字串表示轉換成其對等 64 位元不帶正負號的整數。Converts the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned integer equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

將指定樣式之數字的字串表示轉換成其對等 64 位元不帶正負號的整數。Converts the string representation of a number in a specified style to its 64-bit unsigned integer equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

將數字的字串表示轉換成它的對等 64 位元不帶正負號的整數。Converts the string representation of a number to its 64-bit unsigned integer equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

將指定之特定文化特性格式數字的字串表示轉換成它的對等 64 位元不帶正負號的整數。Converts the string representation of a number in a specified culture-specific format to its 64-bit unsigned integer equivalent.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

使用指定的格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)
TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64) TryParse(String, UInt64)

嘗試將數字的字串表示轉換為 64 位元不帶正負號的整數。Tries to convert the string representation of a number to its 64-bit unsigned integer equivalent. 傳回值會指出轉換成功或失敗。A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, UInt64) TryParse(ReadOnlySpan<Char>, UInt64) TryParse(ReadOnlySpan<Char>, UInt64) TryParse(ReadOnlySpan<Char>, UInt64)
TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64) TryParse(String, NumberStyles, IFormatProvider, UInt64)

嘗試將指定之樣式及特定文化特性格式資訊數字的字串表示,轉換為它的 64 位元不帶正負號的整數對應項。Tries to convert the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned integer equivalent. 傳回值會指出轉換成功或失敗。A return value indicates whether the conversion succeeded or failed.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64) TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)

明確介面實作

IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object)
IConvertible.GetTypeCode() IConvertible.GetTypeCode() IConvertible.GetTypeCode() IConvertible.GetTypeCode()
IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider) IConvertible.ToBoolean(IFormatProvider)

如需這個成員的說明,請參閱 ToBoolean(IFormatProvider)For a description of this member, see ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider) IConvertible.ToByte(IFormatProvider)

如需這個成員的說明,請參閱 ToByte(IFormatProvider)For a description of this member, see ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider) IConvertible.ToChar(IFormatProvider)

如需這個成員的說明,請參閱 ToChar(IFormatProvider)For a description of this member, see ToChar(IFormatProvider).

IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider) IConvertible.ToDateTime(IFormatProvider)

不支援這個轉換。This conversion is not supported. 嘗試使用這個方法會擲回 InvalidCastExceptionAttempting to use this method throws an InvalidCastException.

IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider) IConvertible.ToDecimal(IFormatProvider)

如需這個成員的說明,請參閱 ToDecimal(IFormatProvider)For a description of this member, see ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider) IConvertible.ToDouble(IFormatProvider)

如需這個成員的說明,請參閱 ToDouble(IFormatProvider)For a description of this member, see ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider) IConvertible.ToInt16(IFormatProvider)

如需這個成員的說明,請參閱 ToInt16(IFormatProvider)For a description of this member, see ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider) IConvertible.ToInt32(IFormatProvider)

如需這個成員的說明,請參閱 ToInt32(IFormatProvider)For a description of this member, see ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider) IConvertible.ToInt64(IFormatProvider)

如需這個成員的說明,請參閱 ToInt64(IFormatProvider)For a description of this member, see ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider) IConvertible.ToSByte(IFormatProvider)

如需這個成員的說明,請參閱 ToSByte(IFormatProvider)For a description of this member, see ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider) IConvertible.ToSingle(IFormatProvider)

如需這個成員的說明,請參閱 ToSingle(IFormatProvider)For a description of this member, see ToSingle(IFormatProvider).

IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider) IConvertible.ToType(Type, IFormatProvider)

如需這個成員的說明,請參閱 ToType(Type, IFormatProvider)For a description of this member, see ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider) IConvertible.ToUInt16(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt16(IFormatProvider)For a description of this member, see ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider) IConvertible.ToUInt32(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt32(IFormatProvider)For a description of this member, see ToUInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider) IConvertible.ToUInt64(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt64(IFormatProvider)For a description of this member, see ToUInt64(IFormatProvider).

適用於

執行緒安全性

此型別的所有成員都是安全執行緒。All members of this type are thread safe. 若要修改執行個體狀態會顯示的成員實際上會傳回新的值進行初始化的新執行個體。Members that appear to modify instance state actually return a new instance initialized with the new value. 為與任何其他型別,讀取和寫入共用的變數,其中包含這個型別的執行個體必須受到鎖定,以確保執行緒安全性。As with any other type, reading and writing to a shared variable that contains an instance of this type must be protected by a lock to guarantee thread safety.

另請參閱