UInt32 结构

定义

命名空间:

System

程序集:

System.Runtime.dll

重要

此 API 不符合 CLS。

表示 32 位无符号整数。

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>

[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)>]
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>

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)

继承

Object

ValueType

UInt32

属性

CLSCompliantAttribute

实现

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 的替代类型为 Int64。 Int32 可以改用 来替换 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()	返回值类型 TypeCode 的 UInt32。
IsEvenInteger(UInt32)	确定值是否表示偶数整数。
IsOddInteger(UInt32)	确定值是否表示奇数整数。
IsPow2(UInt32)	确定值是否为 2 的幂。
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 位无符号整数。 一个指示转换是否成功的返回值。

显式接口实现

IAdditionOperators<UInt32,UInt32,UInt32>.Addition(UInt32, UInt32)	将两个值相加以计算其和。
IAdditionOperators<UInt32,UInt32,UInt32>.CheckedAddition(UInt32, UInt32)	将两个值相加以计算其和。
IAdditiveIdentity<UInt32,UInt32>.AdditiveIdentity	获取当前类型的累加标识。
IBinaryInteger<UInt32>.GetByteCount()	获取将作为 的一部分写入的 TryWriteLittleEndian(Span<Byte>, Int32)字节数。
IBinaryInteger<UInt32>.GetShortestBitLength()	获取当前值的最短两个补补表示形式的长度（以位为单位）。
IBinaryInteger<UInt32>.TryReadBigEndian(ReadOnlySpan<Byte>, Boolean, UInt32)	表示 32 位无符号整数。
IBinaryInteger<UInt32>.TryReadLittleEndian(ReadOnlySpan<Byte>, Boolean, UInt32)	表示 32 位无符号整数。
IBinaryInteger<UInt32>.TryWriteBigEndian(Span<Byte>, Int32)	尝试以 big-endian 格式将当前值写入给定范围。
IBinaryInteger<UInt32>.TryWriteLittleEndian(Span<Byte>, Int32)	尝试以 little-endian 格式将当前值写入给定范围。
IBinaryNumber<UInt32>.AllBitsSet	获取二进制类型的实例，其中设置了所有位。
IBitwiseOperators<UInt32,UInt32,UInt32>.BitwiseAnd(UInt32, UInt32)	计算两个值的按位和 。
IBitwiseOperators<UInt32,UInt32,UInt32>.BitwiseOr(UInt32, UInt32)	计算两个值的按位或 。
IBitwiseOperators<UInt32,UInt32,UInt32>.ExclusiveOr(UInt32, UInt32)	计算两个值的独占或两个值。
IBitwiseOperators<UInt32,UInt32,UInt32>.OnesComplement(UInt32)	计算给定值的补补表示形式。
IComparisonOperators<UInt32,UInt32,Boolean>.GreaterThan(UInt32, UInt32)	比较两个值以确定哪个值更大。
IComparisonOperators<UInt32,UInt32,Boolean>.GreaterThanOrEqual(UInt32, UInt32)	比较两个值以确定哪个值更大或相等。
IComparisonOperators<UInt32,UInt32,Boolean>.LessThan(UInt32, UInt32)	比较两个值以确定哪个值较小。
IComparisonOperators<UInt32,UInt32,Boolean>.LessThanOrEqual(UInt32, UInt32)	比较两个值以确定哪个值小于或等于。
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<UInt32>.CheckedDecrement(UInt32)	递减值。
IDecrementOperators<UInt32>.Decrement(UInt32)	递减值。
IDivisionOperators<UInt32,UInt32,UInt32>.Division(UInt32, UInt32)	将一个值除以另一个值以计算其商。
IEqualityOperators<UInt32,UInt32,Boolean>.Equality(UInt32, UInt32)	比较两个值以确定相等性。
IEqualityOperators<UInt32,UInt32,Boolean>.Inequality(UInt32, UInt32)	比较两个值以确定不相等性。
IIncrementOperators<UInt32>.CheckedIncrement(UInt32)	递增值。
IIncrementOperators<UInt32>.Increment(UInt32)	递增值。
IMinMaxValue<UInt32>.MaxValue	获取当前类型的最大值。
IMinMaxValue<UInt32>.MinValue	获取当前类型的最小值。
IModulusOperators<UInt32,UInt32,UInt32>.Modulus(UInt32, UInt32)	将两个值相除以计算其模数或余数。
IMultiplicativeIdentity<UInt32,UInt32>.MultiplicativeIdentity	获取当前类型的乘法标识。
IMultiplyOperators<UInt32,UInt32,UInt32>.CheckedMultiply(UInt32, UInt32)	将两个值相乘以计算其乘积。
IMultiplyOperators<UInt32,UInt32,UInt32>.Multiply(UInt32, UInt32)	将两个值相乘以计算其乘积。
INumber<UInt32>.CopySign(UInt32, UInt32)	将值的符号复制到另一个值的符号。
INumber<UInt32>.MaxNumber(UInt32, UInt32)	比较两个值以计算较大值，如果输入为 ， NaN则返回另一个值。
INumber<UInt32>.MinNumber(UInt32, UInt32)	将两个值进行比较以计算较小的值，如果输入为 NaN，则返回另一个值。
INumberBase<UInt32>.Abs(UInt32)	计算值的绝对值。
INumberBase<UInt32>.IsCanonical(UInt32)	确定值是否在其规范表示形式中。
INumberBase<UInt32>.IsComplexNumber(UInt32)	确定值是否表示复数。
INumberBase<UInt32>.IsFinite(UInt32)	确定值是否为有限值。
INumberBase<UInt32>.IsImaginaryNumber(UInt32)	确定值是否表示纯虚数。
INumberBase<UInt32>.IsInfinity(UInt32)	确定值是否无限。
INumberBase<UInt32>.IsInteger(UInt32)	确定值是否表示整型数。
INumberBase<UInt32>.IsNaN(UInt32)	确定值是否为 NaN。
INumberBase<UInt32>.IsNegative(UInt32)	确定值是否为负值。
INumberBase<UInt32>.IsNegativeInfinity(UInt32)	确定值是否为负无穷大。
INumberBase<UInt32>.IsNormal(UInt32)	确定值是否为正常值。
INumberBase<UInt32>.IsPositive(UInt32)	确定值是否为正值。
INumberBase<UInt32>.IsPositiveInfinity(UInt32)	确定值是否为正无穷大。
INumberBase<UInt32>.IsRealNumber(UInt32)	确定值是否表示实数。
INumberBase<UInt32>.IsSubnormal(UInt32)	确定值是否为非正常值。
INumberBase<UInt32>.IsZero(UInt32)	确定值是否为零。
INumberBase<UInt32>.MaxMagnitude(UInt32, UInt32)	将两个值与计算进行比较，这两个值更大。
INumberBase<UInt32>.MaxMagnitudeNumber(UInt32, UInt32)	比较两个值，以计算其具有更大的数量级并返回另一个值（如果输入为 NaN）。
INumberBase<UInt32>.MinMagnitude(UInt32, UInt32)	将两个值与较小的计算进行比较。
INumberBase<UInt32>.MinMagnitudeNumber(UInt32, UInt32)	将两个值与具有较小数量级的计算进行比较，如果输入为 NaN，则返回另一个值。
INumberBase<UInt32>.One	获取类型的值 1 。
INumberBase<UInt32>.Radix	获取类型的基数。
INumberBase<UInt32>.TryConvertFromChecked<TOther>(TOther, UInt32)	表示 32 位无符号整数。
INumberBase<UInt32>.TryConvertFromSaturating<TOther>(TOther, UInt32)	表示 32 位无符号整数。
INumberBase<UInt32>.TryConvertFromTruncating<TOther>(TOther, UInt32)	表示 32 位无符号整数。
INumberBase<UInt32>.TryConvertToChecked<TOther>(UInt32, TOther)	尝试将当前类型的实例转换为另一种类型，从而对超出当前类型的可表示范围的任何值引发溢出异常。
INumberBase<UInt32>.TryConvertToSaturating<TOther>(UInt32, TOther)	尝试将当前类型的实例转换为另一种类型，使当前类型的可表示范围之外的任何值饱和。
INumberBase<UInt32>.TryConvertToTruncating<TOther>(UInt32, TOther)	尝试将当前类型的实例转换为另一种类型，截断当前类型的可表示范围之外的任何值。
INumberBase<UInt32>.Zero	获取类型的值 0 。
IShiftOperators<UInt32,Int32,UInt32>.LeftShift(UInt32, Int32)	将值左移给定量。
IShiftOperators<UInt32,Int32,UInt32>.RightShift(UInt32, Int32)	将值右移给定量。
IShiftOperators<UInt32,Int32,UInt32>.UnsignedRightShift(UInt32, Int32)	将值右移给定量。
ISubtractionOperators<UInt32,UInt32,UInt32>.CheckedSubtraction(UInt32, UInt32)	减去两个值以计算其差值。
ISubtractionOperators<UInt32,UInt32,UInt32>.Subtraction(UInt32, UInt32)	减去两个值以计算其差值。
IUnaryNegationOperators<UInt32,UInt32>.CheckedUnaryNegation(UInt32)	计算值的已检查一元求反值。
IUnaryNegationOperators<UInt32,UInt32>.UnaryNegation(UInt32)	计算值的一元求反值。
IUnaryPlusOperators<UInt32,UInt32>.UnaryPlus(UInt32)	计算值的一元加号。

线程安全性

此类型的所有成员都是线程安全的。 看起来修改实例状态的成员实际上返回使用新值初始化的新实例。 与任何其他类型一样，读取和写入包含此类型的实例的共享变量必须受到锁的保护，以确保线程安全。

另请参阅

• Int32
• 示例：.NET Core WinForms 格式设置实用工具 (C#)
• 示例：.NET Core WinForms 格式设置实用工具 (Visual Basic)