Export (0) Print
Expand All

BitConverter.GetBytes Method (UInt64)

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

This method is not CLS-compliant.  

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

[CLSCompliantAttribute(false)] 
public static byte[] GetBytes (
	ulong value
)
/** @attribute CLSCompliantAttribute(false) */ 
public static byte[] GetBytes (
	UInt64 value
)
CLSCompliantAttribute(false) 
public static function GetBytes (
	value : ulong
) : byte[]
Not applicable.

Parameters

value

The number to convert.

Return Value

An array of bytes with length 8.

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

// Example of the BitConverter.GetBytes( ulong ) method.
using System;

class GetBytesUInt64Demo
{
    const string formatter = "{0,22}{1,30}";
 
    // Convert a ulong argument to a byte array and display it.
    public static void GetBytesUInt64( ulong argument )
    {
        byte[ ] byteArray = BitConverter.GetBytes( argument );
        Console.WriteLine( formatter, argument, 
            BitConverter.ToString( byteArray ) );
    }
       
    public static void Main( )
    {
        Console.WriteLine( 
            "This example of the BitConverter.GetBytes( ulong ) " +
            "\nmethod generates the following output.\n" );
        Console.WriteLine( formatter, "ulong", "byte array" );
        Console.WriteLine( formatter, "-----", "----------" );
          
        // Convert ulong values and display the results.
        GetBytesUInt64( 0xFFFFFF );
        GetBytesUInt64( 1000000000 );
        GetBytesUInt64( 0x100000000 );
        GetBytesUInt64( 0xAAAAAAAAAAAA );
        GetBytesUInt64( 1000000000000000000 );
        GetBytesUInt64( 10000000000000000000 );
        GetBytesUInt64( ulong.MinValue );
        GetBytesUInt64( long.MaxValue );
        GetBytesUInt64( ulong.MaxValue );
    }
}

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

                 ulong                    byte array
                 -----                    ----------
              16777215       FF-FF-FF-00-00-00-00-00
            1000000000       00-CA-9A-3B-00-00-00-00
            4294967296       00-00-00-00-01-00-00-00
       187649984473770       AA-AA-AA-AA-AA-AA-00-00
   1000000000000000000       00-00-64-A7-B3-B6-E0-0D
  10000000000000000000       00-00-E8-89-04-23-C7-8A
                     0       00-00-00-00-00-00-00-00
   9223372036854775807       FF-FF-FF-FF-FF-FF-FF-7F
  18446744073709551615       FF-FF-FF-FF-FF-FF-FF-FF
*/

// Example of the BitConverter.GetBytes( ulong ) method.
import System.*;

class GetBytesUInt64Demo
{
    private static String formatter = "{0,22}{1,30}";

    // Convert a ulong argument to a byte array and display it.
    public static void GetBytesUInt64(UInt64 argument)
    {
        ubyte byteArray[] = BitConverter.GetBytes(argument);
        Console.WriteLine(formatter, (UInt64)argument, 
            BitConverter.ToString(byteArray));
	} //GetBytesUInt64

    public static void main(String[] args)
    {
        Console.WriteLine("This example of the BitConverter.GetBytes( ulong )"
            + " \nmethod generates the following output.\n");
        Console.WriteLine(formatter, "ulong", "byte array");
        Console.WriteLine(formatter, "-----", "----------");

        // Convert ulong values and display the results.
        GetBytesUInt64((UInt64)(0xFFFFFF));
        GetBytesUInt64((UInt64)1000000000);
        GetBytesUInt64((UInt64)0x100000000L);
        GetBytesUInt64((UInt64)0xAAAAAAAAAAAAL);
        GetBytesUInt64((UInt64)1000000000000000000L);
        GetBytesUInt64(System.UInt64.Parse("10000000000000000000"));
        GetBytesUInt64(UInt64.MinValue);
        GetBytesUInt64((UInt64)Int64.MaxValue);
        GetBytesUInt64(UInt64.MaxValue);
    } //main
} //GetBytesUInt64Demo

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

                 ulong                    byte array
                 -----                    ----------
              16777215       FF-FF-FF-00-00-00-00-00
            1000000000       00-CA-9A-3B-00-00-00-00
            4294967296       00-00-00-00-01-00-00-00
       187649984473770       AA-AA-AA-AA-AA-AA-00-00
   1000000000000000000       00-00-64-A7-B3-B6-E0-0D
  10000000000000000000       00-00-E8-89-04-23-C7-8A
                     0       00-00-00-00-00-00-00-00
   9223372036854775807       FF-FF-FF-FF-FF-FF-FF-7F
  18446744073709551615       FF-FF-FF-FF-FF-FF-FF-FF
*/

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2014 Microsoft