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
- value
Type: System.Int64
The number to convert.
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.