Byte Struct

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

Byte.cs

Represents an 8-bit unsigned integer.

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 IUtf8SpanFormattable
    interface IUtf8SpanParsable<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 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)

Inheritance

Object

ValueType

Byte

Implements

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>

Remarks

For more information about this API, see Supplemental API remarks for Byte.

Fields

MaxValue	Represents the largest possible value of a Byte. This field is constant.
MinValue	Represents the smallest possible value of a Byte. This field is constant.

Methods

Clamp(Byte, Byte, Byte)	Clamps a value to an inclusive minimum and maximum value.
CompareTo(Byte)	Compares this instance to a specified 8-bit unsigned integer and returns an indication of their relative values.
CompareTo(Object)	Compares this instance to a specified object and returns an indication of their relative values.
CreateChecked<TOther>(TOther)	Creates an instance of the current type from a value, throwing an overflow exception for any values that fall outside the representable range of the current type.
CreateSaturating<TOther>(TOther)	Creates an instance of the current type from a value, saturating any values that fall outside the representable range of the current type.
CreateTruncating<TOther>(TOther)	Creates an instance of the current type from a value, truncating any values that fall outside the representable range of the current type.
DivRem(Byte, Byte)	Computes the quotient and remainder of two values.
Equals(Byte)	Returns a value indicating whether this instance and a specified Byte object represent the same value.
Equals(Object)	Returns a value indicating whether this instance is equal to a specified object.
GetHashCode()	Returns the hash code for this instance.
GetTypeCode()	Returns the TypeCode for value type Byte.
IsEvenInteger(Byte)	Determines if a value represents an even integral number.
IsOddInteger(Byte)	Determines if a value represents an odd integral number.
IsPow2(Byte)	Determines if a value is a power of two.
LeadingZeroCount(Byte)	Computes the number of leading zeros in a value.
Log2(Byte)	Computes the log2 of a value.
Max(Byte, Byte)	Compares two values to compute which is greater.
Min(Byte, Byte)	Compares two values to compute which is lesser.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Parses a span of UTF-8 characters into a value.
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	Parses a span of UTF-8 characters into a value.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Parses a span of characters into a value.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent.
Parse(String, IFormatProvider)	Converts the string representation of a number in a specified culture-specific format to its Byte equivalent.
Parse(String, NumberStyles, IFormatProvider)	Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent.
Parse(String, NumberStyles)	Converts the string representation of a number in a specified style to its Byte equivalent.
Parse(String)	Converts the string representation of a number to its Byte equivalent.
PopCount(Byte)	Computes the number of bits that are set in a value.
RotateLeft(Byte, Int32)	Rotates a value left by a given amount.
RotateRight(Byte, Int32)	Rotates a value right by a given amount.
Sign(Byte)	Computes the sign of a value.
ToString()	Converts the value of the current Byte object to its equivalent string representation.
ToString(IFormatProvider)	Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.
ToString(String, IFormatProvider)	Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.
ToString(String)	Converts the value of the current Byte object to its equivalent string representation using the specified format.
TrailingZeroCount(Byte)	Computes the number of trailing zeros in a value.
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tries to format the value of the current instance as UTF-8 into the provided span of bytes.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tries to format the value of the current 8-bit unsigned integer instance into the provided span of characters.
TryParse(ReadOnlySpan<Byte>, Byte)	Tries to convert a UTF-8 character span containing the string representation of a number to its 8-bit unsigned integer equivalent.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Byte)	Tries to parse a span of UTF-8 characters into a value.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Byte)	Tries to parse a span of UTF-8 characters into a value.
TryParse(ReadOnlySpan<Char>, Byte)	Tries to convert the span representation of a number to its Byte equivalent, and returns a value that indicates whether the conversion succeeded.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Byte)	Tries to parse a span of characters into a value.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Byte)	Converts the span representation of a number in a specified style and culture-specific format to its Byte equivalent. A return value indicates whether the conversion succeeded or failed.
TryParse(String, Byte)	Tries to convert the string representation of a number to its Byte equivalent, and returns a value that indicates whether the conversion succeeded.
TryParse(String, IFormatProvider, Byte)	Tries to parse a string into a value.
TryParse(String, NumberStyles, IFormatProvider, Byte)	Converts the string representation of a number in a specified style and culture-specific format to its Byte equivalent. A return value indicates whether the conversion succeeded or failed.

Explicit Interface Implementations

IAdditionOperators<Byte,Byte,Byte>.Addition(Byte, Byte)	Adds two values together to compute their sum.
IAdditionOperators<Byte,Byte,Byte>.CheckedAddition(Byte, Byte)	Adds two values together to compute their sum.
IAdditiveIdentity<Byte,Byte>.AdditiveIdentity	Gets the additive identity of the current type.
IBinaryInteger<Byte>.GetByteCount()	Gets the number of bytes that will be written as part of TryWriteLittleEndian(Span<Byte>, Int32).
IBinaryInteger<Byte>.GetShortestBitLength()	Gets the length, in bits, of the shortest two's complement representation of the current value.
IBinaryInteger<Byte>.TryReadBigEndian(ReadOnlySpan<Byte>, Boolean, Byte)
IBinaryInteger<Byte>.TryReadLittleEndian(ReadOnlySpan<Byte>, Boolean, Byte)
IBinaryInteger<Byte>.TryWriteBigEndian(Span<Byte>, Int32)	Tries to write the current value, in big-endian format, to a given span.
IBinaryInteger<Byte>.TryWriteLittleEndian(Span<Byte>, Int32)	Tries to write the current value, in little-endian format, to a given span.
IBinaryNumber<Byte>.AllBitsSet	Gets an instance of the binary type in which all bits are set.
IBitwiseOperators<Byte,Byte,Byte>.BitwiseAnd(Byte, Byte)	Computes the bitwise-and of two values.
IBitwiseOperators<Byte,Byte,Byte>.BitwiseOr(Byte, Byte)	Computes the bitwise-or of two values.
IBitwiseOperators<Byte,Byte,Byte>.ExclusiveOr(Byte, Byte)	Computes the exclusive-or of two values.
IBitwiseOperators<Byte,Byte,Byte>.OnesComplement(Byte)	Computes the ones-complement representation of a given value.
IComparisonOperators<Byte,Byte,Boolean>.GreaterThan(Byte, Byte)	Compares two values to determine which is greater.
IComparisonOperators<Byte,Byte,Boolean>.GreaterThanOrEqual(Byte, Byte)	Compares two values to determine which is greater or equal.
IComparisonOperators<Byte,Byte,Boolean>.LessThan(Byte, Byte)	Compares two values to determine which is less.
IComparisonOperators<Byte,Byte,Boolean>.LessThanOrEqual(Byte, Byte)	Compares two values to determine which is less or equal.
IConvertible.ToBoolean(IFormatProvider)	For a description of this member, see ToBoolean(IFormatProvider).
IConvertible.ToByte(IFormatProvider)	For a description of this member, see ToByte(IFormatProvider).
IConvertible.ToChar(IFormatProvider)	For a description of this member, see ToChar(IFormatProvider).
IConvertible.ToDateTime(IFormatProvider)	This conversion is not supported. Attempting to use this method throws an InvalidCastException.
IConvertible.ToDecimal(IFormatProvider)	For a description of this member, see ToDecimal(IFormatProvider).
IConvertible.ToDouble(IFormatProvider)	For a description of this member, see ToDouble(IFormatProvider).
IConvertible.ToInt16(IFormatProvider)	For a description of this member, see ToInt16(IFormatProvider).
IConvertible.ToInt32(IFormatProvider)	For a description of this member, see ToInt32(IFormatProvider).
IConvertible.ToInt64(IFormatProvider)	For a description of this member, see ToInt64(IFormatProvider).
IConvertible.ToSByte(IFormatProvider)	For a description of this member, see ToSByte(IFormatProvider).
IConvertible.ToSingle(IFormatProvider)	For a description of this member, see ToSingle(IFormatProvider).
IConvertible.ToType(Type, IFormatProvider)	For a description of this member, see ToType(Type, IFormatProvider).
IConvertible.ToUInt16(IFormatProvider)	For a description of this member, see ToUInt16(IFormatProvider).
IConvertible.ToUInt32(IFormatProvider)	For a description of this member, see ToUInt32(IFormatProvider).
IConvertible.ToUInt64(IFormatProvider)	For a description of this member, see ToUInt64(IFormatProvider).
IDecrementOperators<Byte>.CheckedDecrement(Byte)	Decrements a value.
IDecrementOperators<Byte>.Decrement(Byte)	Decrements a value.
IDivisionOperators<Byte,Byte,Byte>.Division(Byte, Byte)	Divides one value by another to compute their quotient.
IEqualityOperators<Byte,Byte,Boolean>.Equality(Byte, Byte)	Compares two values to determine equality.
IEqualityOperators<Byte,Byte,Boolean>.Inequality(Byte, Byte)	Compares two values to determine inequality.
IIncrementOperators<Byte>.CheckedIncrement(Byte)	Increments a value.
IIncrementOperators<Byte>.Increment(Byte)	Increments a value.
IMinMaxValue<Byte>.MaxValue	Gets the maximum value of the current type.
IMinMaxValue<Byte>.MinValue	Gets the minimum value of the current type.
IModulusOperators<Byte,Byte,Byte>.Modulus(Byte, Byte)	Divides two values together to compute their modulus or remainder.
IMultiplicativeIdentity<Byte,Byte>.MultiplicativeIdentity	Gets the multiplicative identity of the current type.
IMultiplyOperators<Byte,Byte,Byte>.CheckedMultiply(Byte, Byte)	Multiplies two values together to compute their product.
IMultiplyOperators<Byte,Byte,Byte>.Multiply(Byte, Byte)	Multiplies two values together to compute their product.
INumber<Byte>.CopySign(Byte, Byte)	Copies the sign of a value to the sign of another value.
INumber<Byte>.MaxNumber(Byte, Byte)	Compares two values to compute which is greater and returning the other value if an input is NaN.
INumber<Byte>.MinNumber(Byte, Byte)	Compares two values to compute which is lesser and returning the other value if an input is NaN.
INumberBase<Byte>.Abs(Byte)	Computes the absolute of a value.
INumberBase<Byte>.IsCanonical(Byte)	Determines if a value is in its canonical representation.
INumberBase<Byte>.IsComplexNumber(Byte)	Determines if a value represents a complex number.
INumberBase<Byte>.IsFinite(Byte)	Determines if a value is finite.
INumberBase<Byte>.IsImaginaryNumber(Byte)	Determines if a value represents a pure imaginary number.
INumberBase<Byte>.IsInfinity(Byte)	Determines if a value is infinite.
INumberBase<Byte>.IsInteger(Byte)	Determines if a value represents an integral number.
INumberBase<Byte>.IsNaN(Byte)	Determines if a value is NaN.
INumberBase<Byte>.IsNegative(Byte)	Determines if a value is negative.
INumberBase<Byte>.IsNegativeInfinity(Byte)	Determines if a value is negative infinity.
INumberBase<Byte>.IsNormal(Byte)	Determines if a value is normal.
INumberBase<Byte>.IsPositive(Byte)	Determines if a value is positive.
INumberBase<Byte>.IsPositiveInfinity(Byte)	Determines if a value is positive infinity.
INumberBase<Byte>.IsRealNumber(Byte)	Determines if a value represents a real number.
INumberBase<Byte>.IsSubnormal(Byte)	Determines if a value is subnormal.
INumberBase<Byte>.IsZero(Byte)	Determines if a value is zero.
INumberBase<Byte>.MaxMagnitude(Byte, Byte)	Compares two values to compute which is greater.
INumberBase<Byte>.MaxMagnitudeNumber(Byte, Byte)	Compares two values to compute which has the greater magnitude and returning the other value if an input is NaN.
INumberBase<Byte>.MinMagnitude(Byte, Byte)	Compares two values to compute which is lesser.
INumberBase<Byte>.MinMagnitudeNumber(Byte, Byte)	Compares two values to compute which has the lesser magnitude and returning the other value if an input is NaN.
INumberBase<Byte>.MultiplyAddEstimate(Byte, Byte, Byte)	Computes an estimate of (left * right) + addend.
INumberBase<Byte>.One	Gets the value 1 for the type.
INumberBase<Byte>.Radix	Gets the radix, or base, for the type.
INumberBase<Byte>.TryConvertFromChecked<TOther>(TOther, Byte)
INumberBase<Byte>.TryConvertFromSaturating<TOther>(TOther, Byte)
INumberBase<Byte>.TryConvertFromTruncating<TOther>(TOther, Byte)
INumberBase<Byte>.TryConvertToChecked<TOther>(Byte, TOther)	Tries to convert an instance of the the current type to another type, throwing an overflow exception for any values that fall outside the representable range of the current type.
INumberBase<Byte>.TryConvertToSaturating<TOther>(Byte, TOther)	Tries to convert an instance of the the current type to another type, saturating any values that fall outside the representable range of the current type.
INumberBase<Byte>.TryConvertToTruncating<TOther>(Byte, TOther)	Tries to convert an instance of the the current type to another type, truncating any values that fall outside the representable range of the current type.
INumberBase<Byte>.Zero	Gets the value 0 for the type.
IShiftOperators<Byte,Int32,Byte>.LeftShift(Byte, Int32)	Shifts a value left by a given amount.
IShiftOperators<Byte,Int32,Byte>.RightShift(Byte, Int32)	Shifts a value right by a given amount.
IShiftOperators<Byte,Int32,Byte>.UnsignedRightShift(Byte, Int32)	Shifts a value right by a given amount.
ISubtractionOperators<Byte,Byte,Byte>.CheckedSubtraction(Byte, Byte)	Subtracts two values to compute their difference.
ISubtractionOperators<Byte,Byte,Byte>.Subtraction(Byte, Byte)	Subtracts two values to compute their difference.
IUnaryNegationOperators<Byte,Byte>.CheckedUnaryNegation(Byte)	Computes the checked unary negation of a value.
IUnaryNegationOperators<Byte,Byte>.UnaryNegation(Byte)	Computes the unary negation of a value.
IUnaryPlusOperators<Byte,Byte>.UnaryPlus(Byte)	Computes the unary plus of a value.

Thread Safety

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.

See also

• SByte
• IComparable
• IFormattable
• IConvertible
• Sample: .NET Core WinForms Formatting Utility (C#)
• Sample: .NET Core WinForms Formatting Utility (Visual Basic)