Byte 结构

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

Byte.cs

表示 8 位无符号整数。

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

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

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

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

继承

Object

ValueType

Byte

实现

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

注解

有关此 API 的详细信息，请参阅字节补充 API 备注。

字段

MaxValue	表示 Byte的最大可能值。 此字段为常量。
MinValue	表示 Byte的最小可能值。 此字段为常量。

方法

Clamp(Byte, Byte, Byte)	将值固定到非独占最小值和最大值。
CompareTo(Byte)	将此实例与指定的 8 位无符号整数进行比较，并返回其相对值的指示。
CompareTo(Object)	将此实例与指定的对象进行比较，并返回其相对值的指示。
CreateChecked<TOther>(TOther)	从值创建当前类型的实例，为超出当前类型的可表示范围的任何值引发溢出异常。
CreateSaturating<TOther>(TOther)	从值创建当前类型的实例，使属于当前类型的可表示范围之外的任何值饱和。
CreateTruncating<TOther>(TOther)	从值创建当前类型的实例，截断属于当前类型的可表示范围之外的任何值。
DivRem(Byte, Byte)	计算两个值的商和余数。
Equals(Byte)	返回一个值，该值指示此实例和指定的 Byte 对象是否表示相同的值。
Equals(Object)	返回一个值，该值指示此实例是否等于指定的对象。
GetHashCode()	返回此实例的哈希代码。
GetTypeCode()	返回值类型 Byte的 TypeCode。
IsEvenInteger(Byte)	确定值是否表示偶数。
IsOddInteger(Byte)	确定值是否表示奇数整数。
IsPow2(Byte)	确定值是否为 2 的幂。
LeadingZeroCount(Byte)	计算值中的前导零数。
Log2(Byte)	计算值的 log2。
Max(Byte, Byte)	比较两个值与计算值更大。
Min(Byte, Byte)	比较两个值与计算值较小。
Parse(ReadOnlySpan<Byte>, IFormatProvider)	将 UTF-8 字符的范围分析为值。
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	将 UTF-8 字符的范围分析为值。
Parse(ReadOnlySpan<Char>, IFormatProvider)	将字符的范围分析为值。
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	将指定样式和区域性特定格式的数字的跨度表示形式转换为其等效 Byte。
Parse(String)	将数字的字符串表示形式转换为其等效 Byte。
Parse(String, IFormatProvider)	将指定区域性特定格式的数字的字符串表示形式转换为其等效 Byte。
Parse(String, NumberStyles)	将指定样式中的数字的字符串表示形式转换为其等效 Byte。
Parse(String, NumberStyles, IFormatProvider)	将指定样式和区域性特定格式的数字的字符串表示形式转换为其等效 Byte。
PopCount(Byte)	计算值中设置的位数。
RotateLeft(Byte, Int32)	按给定量旋转一个值。
RotateRight(Byte, Int32)	按给定的量向右旋转值。
Sign(Byte)	计算值的符号。
ToString()	将当前 Byte 对象的值转换为其等效的字符串表示形式。
ToString(IFormatProvider)	使用指定的区域性特定的格式设置信息将当前 Byte 对象的数值转换为其等效的字符串表示形式。
ToString(String)	使用指定格式将当前 Byte 对象的值转换为其等效的字符串表示形式。
ToString(String, IFormatProvider)	使用指定的格式和区域性特定的格式信息将当前 Byte 对象的值转换为其等效的字符串表示形式。
TrailingZeroCount(Byte)	计算值中的尾随零数。
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	尝试将当前实例的值格式化为 UTF-8，并将其设置为提供的字节范围。
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	尝试将当前 8 位无符号整数实例的值格式化为提供的字符范围。
TryParse(ReadOnlySpan<Byte>, Byte)	尝试将包含数字字符串表示形式的 UTF-8 字符范围转换为其等效的 8 位无符号整数。
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Byte)	尝试将 UTF-8 字符的范围分析为值。
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Byte)	尝试将 UTF-8 字符的范围分析为值。
TryParse(ReadOnlySpan<Char>, Byte)	尝试将数字的跨度表示形式转换为其等效 Byte，并返回一个值，该值指示转换是否成功。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Byte)	尝试将字符范围分析为值。
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Byte)	将指定样式和区域性特定格式的数字的跨度表示形式转换为其等效 Byte。 返回值指示转换是成功还是失败。
TryParse(String, Byte)	尝试将数字的字符串表示形式转换为其等效 Byte，并返回一个值，该值指示转换是否成功。
TryParse(String, IFormatProvider, Byte)	尝试将字符串分析为值。
TryParse(String, NumberStyles, IFormatProvider, Byte)	将指定样式和区域性特定格式的数字的字符串表示形式转换为其等效 Byte。 返回值指示转换是成功还是失败。

显式接口实现

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

线程安全性

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

另请参阅

• SByte
• IComparable
• IFormattable
• IConvertible
• 示例：.NET Core WinForms 格式设置实用工具 （C#）
• 示例：.NET Core WinForms 格式设置实用工具 （Visual Basic）