Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Byte Structure

Represents an 8-bit unsigned integer.

For a list of all members of this type, see Byte Members.


[Visual Basic]
Public Structure Byte
   Implements IComparable, IFormattable, IConvertible
public struct Byte : IComparable, IFormattable, IConvertible
public __value struct Byte : public IComparable, IFormattable,

[JScript] In JScript, you can use the structures in the .NET Framework, but you cannot define your own.

Thread Safety

This type is safe for multithreaded operations.


The Byte value type represents unsigned integers with values ranging from 0 to 255.

Byte 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.

For information about how format specification codes control the string representation of value types, see Formatting Overview.

This type implements interfaces IComparable, IFormattable, and IConvertible. Use the Convert class for conversions instead of this type's explicit interface member implementation of IConvertible.

This type is thread safe; multiple threads can concurrently read from an instance of this type.


[Visual Basic, C#, C++] The following example demonstrates the use of Byte when converting an array of bytes into a string of hexadecimal values.

[Visual Basic] 
Class HexTest

   Private Shared hexDigits As Char() =  {"0"c, "1"c, "2"c, "3"c, "4"c, "5"c, "6"c, "7"c, "8"c, "9"c, "A"c, "B"c, "C"c, "D"c, "E"c, "F"c}
   Public Shared Function ToHexString(bytes() As Byte) As String

      Dim hexStr As String = ""
      Dim i As Integer
      For i = 0 To bytes.Length - 1
     hexStr = hexStr + Hex(bytes(i))
      Next i
      Return hexStr 

   End Function 'ToHexString

   Shared Sub Main()
      Dim b As Byte() =  {&H0, &H12, &H34, &H56, &HAA, &H55, &HFF}

   End Sub 'Main

End Class 'HexTest

class HexTest
    static char[] hexDigits = {
        '0', '1', '2', '3', '4', '5', '6', '7',
        '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
    public static string ToHexString(byte[] bytes) {
        char[] chars = new char[bytes.Length * 2];
        for (int i = 0; i < bytes.Length; i++) {
            int b = bytes[i];
            chars[i * 2] = hexDigits[b >> 4];
            chars[i * 2 + 1] = hexDigits[b & 0xF];
        return new string(chars);
    static void Main() {

        byte[] b = {0x00, 0x12, 0x34, 0x56, 0xAA, 0x55, 0xFF};

__gc class HexTest
   static Char hexDigits[] = {
      '0', '1', '2', '3', '4', '5', '6', '7',
      '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};

   static String* ToHexString(Byte bytes[]) {
      Char chars[] = new Char[bytes->Length * 2];
      for (int i = 0; i < bytes->Length; i++) {
         int b = bytes[i];
         chars[i * 2] = hexDigits[b >> 4];
         chars[i * 2 + 1] = hexDigits[b & 0xF];
      return new String(chars);

int main() {

   Byte b[] = {0x00, 0x12, 0x34, 0x56, 0xAA, 0x55, 0xFF};

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.


Namespace: System

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

Assembly: Mscorlib (in Mscorlib.dll)

See Also

Byte Members | System Namespace | SByte | String | IComparable | IFormattable | IConvertible

© 2017 Microsoft