UInt32 結構

定義

重要

此 API 不符合 CLS 規範。

表示 32 位元不帶正負號的整數 (Unsigned Integer)。

public value class System::UInt32 : IComparable, IComparable<System::UInt32>, IConvertible, IEquatable<System::UInt32>, IFormattable
public value class System::UInt32 : IComparable, IComparable<System::UInt32>, IConvertible, IEquatable<System::UInt32>, ISpanFormattable
public value class System::UInt32 : IComparable<System::UInt32>, IConvertible, IEquatable<System::UInt32>, IParsable<System::UInt32>, ISpanParsable<System::UInt32>, System::Numerics::IAdditionOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::IAdditiveIdentity<System::UInt32, System::UInt32>, System::Numerics::IBinaryInteger<System::UInt32>, System::Numerics::IBinaryNumber<System::UInt32>, System::Numerics::IBitwiseOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::IComparisonOperators<System::UInt32, System::UInt32, bool>, System::Numerics::IDecrementOperators<System::UInt32>, System::Numerics::IDivisionOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::IEqualityOperators<System::UInt32, System::UInt32, bool>, System::Numerics::IIncrementOperators<System::UInt32>, System::Numerics::IMinMaxValue<System::UInt32>, System::Numerics::IModulusOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::IMultiplicativeIdentity<System::UInt32, System::UInt32>, System::Numerics::IMultiplyOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::INumber<System::UInt32>, System::Numerics::INumberBase<System::UInt32>, System::Numerics::IShiftOperators<System::UInt32, int, System::UInt32>, System::Numerics::ISubtractionOperators<System::UInt32, System::UInt32, System::UInt32>, System::Numerics::IUnaryNegationOperators<System::UInt32, System::UInt32>, System::Numerics::IUnaryPlusOperators<System::UInt32, System::UInt32>, System::Numerics::IUnsignedNumber<System::UInt32>
public value class System::UInt32 : IComparable, IConvertible, IFormattable
public value class System::UInt32 : IComparable, IComparable<System::UInt32>, IEquatable<System::UInt32>, IFormattable
[System.CLSCompliant(false)]
public struct UInt32 : IComparable, IComparable<uint>, IConvertible, IEquatable<uint>, IFormattable
[System.CLSCompliant(false)]
public readonly struct UInt32 : IComparable, IComparable<uint>, IConvertible, IEquatable<uint>, IFormattable
[System.CLSCompliant(false)]
public readonly struct UInt32 : IComparable, IComparable<uint>, IConvertible, IEquatable<uint>, ISpanFormattable
[System.CLSCompliant(false)]
public readonly struct UInt32 : IComparable<uint>, IConvertible, IEquatable<uint>, IParsable<uint>, ISpanParsable<uint>, System.Numerics.IAdditionOperators<uint,uint,uint>, System.Numerics.IAdditiveIdentity<uint,uint>, System.Numerics.IBinaryInteger<uint>, System.Numerics.IBinaryNumber<uint>, System.Numerics.IBitwiseOperators<uint,uint,uint>, System.Numerics.IComparisonOperators<uint,uint,bool>, System.Numerics.IDecrementOperators<uint>, System.Numerics.IDivisionOperators<uint,uint,uint>, System.Numerics.IEqualityOperators<uint,uint,bool>, System.Numerics.IIncrementOperators<uint>, System.Numerics.IMinMaxValue<uint>, System.Numerics.IModulusOperators<uint,uint,uint>, System.Numerics.IMultiplicativeIdentity<uint,uint>, System.Numerics.IMultiplyOperators<uint,uint,uint>, System.Numerics.INumber<uint>, System.Numerics.INumberBase<uint>, System.Numerics.IShiftOperators<uint,int,uint>, System.Numerics.ISubtractionOperators<uint,uint,uint>, System.Numerics.IUnaryNegationOperators<uint,uint>, System.Numerics.IUnaryPlusOperators<uint,uint>, System.Numerics.IUnsignedNumber<uint>
[System.CLSCompliant(false)]
[System.Serializable]
public struct UInt32 : IComparable, IConvertible, IFormattable
[System.CLSCompliant(false)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct UInt32 : IComparable, IComparable<uint>, IConvertible, IEquatable<uint>, IFormattable
[System.CLSCompliant(false)]
public struct UInt32 : IComparable, IComparable<uint>, IEquatable<uint>, IFormattable
[<System.CLSCompliant(false)>]
type uint32 = struct
    interface IConvertible
    interface IFormattable
[<System.CLSCompliant(false)>]
type uint32 = struct
    interface IConvertible
    interface ISpanFormattable
    interface IFormattable
[<System.CLSCompliant(false)>]
type uint32 = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<uint32>
    interface ISpanFormattable
    interface ISpanParsable<uint32>
    interface IAdditionOperators<uint32, uint32, uint32>
    interface IAdditiveIdentity<uint32, uint32>
    interface IBinaryInteger<uint32>
    interface IBinaryNumber<uint32>
    interface IBitwiseOperators<uint32, uint32, uint32>
    interface IComparisonOperators<uint32, uint32, bool>
    interface IEqualityOperators<uint32, uint32, bool>
    interface IDecrementOperators<uint32>
    interface IDivisionOperators<uint32, uint32, uint32>
    interface IIncrementOperators<uint32>
    interface IModulusOperators<uint32, uint32, uint32>
    interface IMultiplicativeIdentity<uint32, uint32>
    interface IMultiplyOperators<uint32, uint32, uint32>
    interface INumber<uint32>
    interface INumberBase<uint32>
    interface ISubtractionOperators<uint32, uint32, uint32>
    interface IUnaryNegationOperators<uint32, uint32>
    interface IUnaryPlusOperators<uint32, uint32>
    interface IShiftOperators<uint32, int, uint32>
    interface IMinMaxValue<uint32>
    interface IUnsignedNumber<uint32>
[<System.CLSCompliant(false)>]
[<System.Serializable>]
type uint32 = struct
    interface IFormattable
    interface IConvertible
[<System.CLSCompliant(false)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type uint32 = struct
    interface IFormattable
    interface IConvertible
[<System.CLSCompliant(false)>]
type uint32 = struct
    interface IFormattable
Public Structure UInt32
Implements IComparable, IComparable(Of UInteger), IConvertible, IEquatable(Of UInteger), IFormattable
Public Structure UInt32
Implements IComparable, IComparable(Of UInteger), IConvertible, IEquatable(Of UInteger), ISpanFormattable
Public Structure UInt32
Implements IAdditionOperators(Of UInteger, UInteger, UInteger), IAdditiveIdentity(Of UInteger, UInteger), IBinaryInteger(Of UInteger), IBinaryNumber(Of UInteger), IBitwiseOperators(Of UInteger, UInteger, UInteger), IComparable(Of UInteger), IComparisonOperators(Of UInteger, UInteger, Boolean), IConvertible, IDecrementOperators(Of UInteger), IDivisionOperators(Of UInteger, UInteger, UInteger), IEqualityOperators(Of UInteger, UInteger, Boolean), IEquatable(Of UInteger), IIncrementOperators(Of UInteger), IMinMaxValue(Of UInteger), IModulusOperators(Of UInteger, UInteger, UInteger), IMultiplicativeIdentity(Of UInteger, UInteger), IMultiplyOperators(Of UInteger, UInteger, UInteger), INumber(Of UInteger), INumberBase(Of UInteger), IParsable(Of UInteger), IShiftOperators(Of UInteger, Integer, UInteger), ISpanParsable(Of UInteger), ISubtractionOperators(Of UInteger, UInteger, UInteger), IUnaryNegationOperators(Of UInteger, UInteger), IUnaryPlusOperators(Of UInteger, UInteger), IUnsignedNumber(Of UInteger)
Public Structure UInt32
Implements IComparable, IConvertible, IFormattable
Public Structure UInt32
Implements IComparable, IComparable(Of UInteger), IEquatable(Of UInteger), IFormattable
繼承
UInt32
屬性
實作
IComparable IComparable<UInt32> IConvertible IEquatable<UInt32> IFormattable ISpanFormattable IComparable<TSelf> IEquatable<TSelf> IParsable<UInt32> IParsable<TSelf> ISpanParsable<UInt32> ISpanParsable<TSelf> IAdditionOperators<UInt32,UInt32,UInt32> IAdditionOperators<TSelf,TSelf,TSelf> IAdditiveIdentity<UInt32,UInt32> IAdditiveIdentity<TSelf,TSelf> IBinaryInteger<UInt32> IBinaryNumber<UInt32> IBinaryNumber<TSelf> IBitwiseOperators<UInt32,UInt32,UInt32> IBitwiseOperators<TSelf,TSelf,TSelf> IComparisonOperators<UInt32,UInt32,Boolean> IComparisonOperators<TSelf,TSelf,Boolean> IDecrementOperators<UInt32> IDecrementOperators<TSelf> IDivisionOperators<UInt32,UInt32,UInt32> IDivisionOperators<TSelf,TSelf,TSelf> IEqualityOperators<UInt32,UInt32,Boolean> IEqualityOperators<TSelf,TOther,TResult> IEqualityOperators<TSelf,TSelf,Boolean> IIncrementOperators<UInt32> IIncrementOperators<TSelf> IMinMaxValue<UInt32> IModulusOperators<UInt32,UInt32,UInt32> IModulusOperators<TSelf,TSelf,TSelf> IMultiplicativeIdentity<UInt32,UInt32> IMultiplicativeIdentity<TSelf,TSelf> IMultiplyOperators<UInt32,UInt32,UInt32> IMultiplyOperators<TSelf,TSelf,TSelf> INumber<UInt32> INumber<TSelf> INumberBase<UInt32> INumberBase<TSelf> IShiftOperators<UInt32,Int32,UInt32> IShiftOperators<TSelf,Int32,TSelf> ISubtractionOperators<UInt32,UInt32,UInt32> ISubtractionOperators<TSelf,TSelf,TSelf> IUnaryNegationOperators<UInt32,UInt32> IUnaryNegationOperators<TSelf,TSelf> IUnaryPlusOperators<UInt32,UInt32> IUnaryPlusOperators<TSelf,TSelf> IUnsignedNumber<UInt32>

備註

UInt32 類型代表不帶正負號的整數,其值範圍從 0 到 4,294,967,295。

重要

類型 UInt32 不符合 CLS 規範。 符合 CLS 標準的替代類型為 Int64Int32 可以改用 取代 UInt32 範圍從零到 MaxValue 的值。 如需 CLS 合規性的詳細資訊,請參閱 語言獨立和Language-Independent元件

UInt32 提供比較此型別實例的方法、將實例的值轉換為其 String 標記法,以及將數位的表示轉換成 String 這個類型的實例。

如需格式規格代碼如何控制 String 實值型別表示的詳細資訊,請參閱 格式化類型

欄位

MaxValue

代表 UInt32 最大的可能值。 這個欄位為常數。

MinValue

代表 UInt32 最小的可能值。 這個欄位為常數。

方法

Clamp(UInt32, UInt32, UInt32)

將值限制為內含最小值和最大值。

CompareTo(Object)

將這個執行個體與指定的物件相比較,並傳回它們的相對值指示。

CompareTo(UInt32)

將這個執行個體與指定的 32 位元不帶正負號的整數相比較,並傳回它們的相對值指示。

CreateChecked<TOther>(TOther)

從值建立目前型別的實例,針對落在目前類型可表示範圍以外的任何值擲回溢位例外狀況。

CreateSaturating<TOther>(TOther)

從值建立目前型別的實例,使落在目前類型可表示範圍以外的任何值飽和。

CreateTruncating<TOther>(TOther)

從值建立目前型別的實例,截斷任何落在目前類型可表示範圍以外的值。

DivRem(UInt32, UInt32)

計算兩個值的商數和餘數。

Equals(Object)

傳回值,該值表示這個執行個體是否和指定的物件相等。

Equals(UInt32)

傳回值,表示這個執行個體是否等於指定的 UInt32

GetHashCode()

傳回這個執行個體的雜湊碼。

GetTypeCode()

傳回實值類型 TypeCodeUInt32

IsEvenInteger(UInt32)

判斷值是否代表偶數整數。

IsOddInteger(UInt32)

判斷值是否代表奇數整數。

IsPow2(UInt32)

判斷值是否為兩個的乘冪。

LeadingZeroCount(UInt32)

計算值中的前置零數目。

Log2(UInt32)

計算值的 log2。

Max(UInt32, UInt32)

比較兩個值與大於的計算。

Min(UInt32, UInt32)

比較兩個值與比較較少的計算。

Parse(ReadOnlySpan<Char>, IFormatProvider)

將字元範圍剖析為值。

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等 32 位元不帶正負號的整數。

Parse(String)

將數字的字串表示轉換成它的對等 32 位元不帶正負號的整數。

Parse(String, IFormatProvider)

將指定之特定文化特性格式數字的字串表示轉換成它的對等 32 位元不帶正負號的整數。

Parse(String, NumberStyles)

將指定樣式之數字的字串表示轉換成其對等 32 位元不帶正負號的整數。

Parse(String, NumberStyles, IFormatProvider)

將指定樣式和特定文化特性格式之數字的字串表示轉換成其對等 32 位元不帶正負號的整數。

PopCount(UInt32)

計算值中所設定的位數。

RotateLeft(UInt32, Int32)

旋轉指定數量所留下的值。

RotateRight(UInt32, Int32)

以指定的數量向右旋轉值。

Sign(UInt32)

計算值的符號。

ToString()

將這個執行個體的數值轉換為其相等字串表示。

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。

ToString(String)

使用指定的格式,將這個執行個體的數值轉換成它的相等字串表示。

ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。

TrailingZeroCount(UInt32)

計算值中尾端零的數目。

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

嘗試將目前不帶正負號的整數執行個體值格式化為所提供的字元範圍。

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt32)

嘗試將字元範圍剖析成值。

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

嘗試將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等 32 位元不帶正負號的整數。 傳回值,該值指出轉換成功或失敗。

TryParse(ReadOnlySpan<Char>, UInt32)

嘗試將數字的範圍表示轉換為其對等 32 位元不帶正負號的整數。 傳回值,該值指出轉換成功或失敗。

TryParse(String, IFormatProvider, UInt32)

嘗試將字串剖析成值。

TryParse(String, NumberStyles, IFormatProvider, UInt32)

嘗試將指定之樣式及特定文化特性格式資訊數字的字串表示,轉換為它的 32 位元不帶正負號的整數對應項。 傳回值,該值指出轉換成功或失敗。

TryParse(String, UInt32)

嘗試將數字的字串表示轉換為 32 位元不帶正負號的整數。 傳回值,該值指出轉換成功或失敗。

明確介面實作

IBinaryInteger<UInt32>.GetByteCount()

取得將寫入為 的 TryWriteLittleEndian(Span<Byte>, Int32) 位元組數目。

IBinaryInteger<UInt32>.GetShortestBitLength()

取得目前值之最短兩個補數標記法的長度,以位為單位。

IBinaryInteger<UInt32>.TryWriteBigEndian(Span<Byte>, Int32)

嘗試將目前值以大端格式寫入指定的範圍。

IBinaryInteger<UInt32>.TryWriteLittleEndian(Span<Byte>, Int32)

嘗試將目前值以小到尾格式寫入指定的範圍。

IComparable.CompareTo(Object)

將這個執行個體與指定的物件相比較,並傳回它們的相對值指示。

IConvertible.GetTypeCode()

傳回實值類型 TypeCodeUInt32

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)

適用於

執行緒安全性

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

另請參閱