Share via


BitConverter.GetBytes Method (Int64)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns the specified 64-bit signed integer value as an array of bytes.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Function GetBytes ( _
    value As Long _
) As Byte()
[SecuritySafeCriticalAttribute]
public static byte[] GetBytes(
    long value
)

Parameters

Return Value

Type: array<System.Byte[]
An array of bytes with length 8.

Examples

The following code example converts the bit patterns of Int64 values to Byte arrays with the GetBytes method.

' Example of the BitConverter.GetBytes( Long ) method.

Module Example

   Const formatter As String = "{0,22}{1,30}"

   ' Convert a Long argument to a Byte array and display it.
   Sub GetBytesInt64(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal argument As Long)

      Dim byteArray As Byte() = BitConverter.GetBytes(argument)
      outputBlock.Text &= String.Format(formatter, argument, _
          BitConverter.ToString(byteArray)) & vbCrLf
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      outputBlock.Text &= String.Format( _
          "This example of the BitConverter.GetBytes( Long ) " & _
          vbCrLf & "method generates the following " & _
          "output." & vbCrLf) & vbCrLf
      outputBlock.Text &= String.Format(formatter, "Long", "Byte array") & vbCrLf
      outputBlock.Text &= String.Format(formatter, "----", "----------") & vbCrLf

      ' Convert Long values and display the results.
      GetBytesInt64(outputBlock, 0)
      GetBytesInt64(outputBlock, &HFFFFFF)
      GetBytesInt64(outputBlock, -&HFFFFFF)
      GetBytesInt64(outputBlock, 1000000000)
      GetBytesInt64(outputBlock, -1000000000)
      GetBytesInt64(outputBlock, &H100000000)
      GetBytesInt64(outputBlock, -&H100000000)
      GetBytesInt64(outputBlock, &HAAAAAAAAAAAA)
      GetBytesInt64(outputBlock, -&HAAAAAAAAAAAA)
      GetBytesInt64(outputBlock, 1000000000000000000)
      GetBytesInt64(outputBlock, -1000000000000000000)
      GetBytesInt64(outputBlock, Long.MinValue)
      GetBytesInt64(outputBlock, Long.MaxValue)
   End Sub
End Module

' This example of the BitConverter.GetBytes( Long )
' method generates the following output.
' 
'                   Long                    Byte array
'                   ----                    ----------
'                      0       00-00-00-00-00-00-00-00
'               16777215       FF-FF-FF-00-00-00-00-00
'              -16777215       01-00-00-FF-FF-FF-FF-FF
'             1000000000       00-CA-9A-3B-00-00-00-00
'            -1000000000       00-36-65-C4-FF-FF-FF-FF
'             4294967296       00-00-00-00-01-00-00-00
'            -4294967296       00-00-00-00-FF-FF-FF-FF
'        187649984473770       AA-AA-AA-AA-AA-AA-00-00
'       -187649984473770       56-55-55-55-55-55-FF-FF
'    1000000000000000000       00-00-64-A7-B3-B6-E0-0D
'   -1000000000000000000       00-00-9C-58-4C-49-1F-F2
'   -9223372036854775808       00-00-00-00-00-00-00-80
'    9223372036854775807       FF-FF-FF-FF-FF-FF-FF-7F
// Example of the BitConverter.GetBytes( long ) method.
using System;

class Example
{
   const string formatter = "{0,22}{1,30}";

   // Convert a long argument to a byte array and display it.
   public static void GetBytesInt64(System.Windows.Controls.TextBlock outputBlock, long argument)
   {
      byte[] byteArray = BitConverter.GetBytes(argument);
      outputBlock.Text += String.Format(formatter, argument,
          BitConverter.ToString(byteArray)) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text += String.Format(
          "This example of the BitConverter.GetBytes( long ) " +
          "\nmethod generates the following output.\n") + "\n";
      outputBlock.Text += String.Format(formatter, "long", "byte array") + "\n";
      outputBlock.Text += String.Format(formatter, "----", "----------") + "\n";

      // Convert long values and display the results.
      GetBytesInt64(outputBlock, 0);
      GetBytesInt64(outputBlock, 0xFFFFFF);
      GetBytesInt64(outputBlock, -0xFFFFFF);
      GetBytesInt64(outputBlock, 1000000000);
      GetBytesInt64(outputBlock, -1000000000);
      GetBytesInt64(outputBlock, 0x100000000);
      GetBytesInt64(outputBlock, -0x100000000);
      GetBytesInt64(outputBlock, 0xAAAAAAAAAAAA);
      GetBytesInt64(outputBlock, -0xAAAAAAAAAAAA);
      GetBytesInt64(outputBlock, 1000000000000000000);
      GetBytesInt64(outputBlock, -1000000000000000000);
      GetBytesInt64(outputBlock, long.MinValue);
      GetBytesInt64(outputBlock, long.MaxValue);
   }
}

/*
This example of the BitConverter.GetBytes( long )
method generates the following output.

                  long                    byte array
                  ----                    ----------
                     0       00-00-00-00-00-00-00-00
              16777215       FF-FF-FF-00-00-00-00-00
             -16777215       01-00-00-FF-FF-FF-FF-FF
            1000000000       00-CA-9A-3B-00-00-00-00
           -1000000000       00-36-65-C4-FF-FF-FF-FF
            4294967296       00-00-00-00-01-00-00-00
           -4294967296       00-00-00-00-FF-FF-FF-FF
       187649984473770       AA-AA-AA-AA-AA-AA-00-00
      -187649984473770       56-55-55-55-55-55-FF-FF
   1000000000000000000       00-00-64-A7-B3-B6-E0-0D
  -1000000000000000000       00-00-9C-58-4C-49-1F-F2
  -9223372036854775808       00-00-00-00-00-00-00-80
   9223372036854775807       FF-FF-FF-FF-FF-FF-FF-7F
*/

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.