BigInteger.ToByteArray BigInteger.ToByteArray BigInteger.ToByteArray BigInteger.ToByteArray Method

Определение

Перегрузки

ToByteArray() ToByteArray() ToByteArray() ToByteArray()

Преобразует значение BigInteger в массив байтов.Converts a BigInteger value to a byte array.

ToByteArray(Boolean, Boolean) ToByteArray(Boolean, Boolean) ToByteArray(Boolean, Boolean)

ToByteArray() ToByteArray() ToByteArray() ToByteArray()

Преобразует значение BigInteger в массив байтов.Converts a BigInteger value to a byte array.

public:
 cli::array <System::Byte> ^ ToByteArray();
public byte[] ToByteArray ();
member this.ToByteArray : unit -> byte[]
Public Function ToByteArray () As Byte()

Возвраты

Byte[]

Значение текущего объекта BigInteger, преобразованное в массив байтов.The value of the current BigInteger object converted to an array of bytes.

Примеры

В следующем примере показано, как некоторые BigInteger значения представлены в массивы байтов.The following example illustrates how some BigInteger values are represented in byte arrays.

using System;
using System.Numerics;

public class Example
{
   static byte[] bytes;
   
   public static void Main()
   {
      BigInteger[] numbers = { BigInteger.MinusOne, BigInteger.One, 
                               BigInteger.Zero, 120, 128, 255, 1024, 
                               Int64.MinValue, Int64.MaxValue, 
                               BigInteger.Parse("90123123981293054321") };
      foreach (BigInteger number in numbers)
      {
         bytes = number.ToByteArray();
         Console.Write("{0} ({1}) -> ", number, number.ToString(GetSpecifier()));
         Console.Write("{0} bytes: ", bytes.Length);
         foreach (byte byteValue in bytes)
            Console.Write("{0:X2} ", byteValue);

         Console.WriteLine();
      }   
   }

   private static string GetSpecifier()
   {
      return "X" + (bytes.Length * 2).ToString();
   }
}
// The example displays the following output:
//    -1 (FF) -> 1 bytes: FF
//    1 (01) -> 1 bytes: 01
//    0 (00) -> 1 bytes: 00
//    120 (78) -> 1 bytes: 78
//    128 (0080) -> 2 bytes: 80 00
//    255 (00FF) -> 2 bytes: FF 00
//    1024 (0400) -> 2 bytes: 00 04
//    -9223372036854775808 (8000000000000000) -> 8 bytes: 00 00 00 00 00 00 00 80
//    9223372036854775807 (7FFFFFFFFFFFFFFF) -> 8 bytes: FF FF FF FF FF FF FF 7F
//    90123123981293054321 (04E2B5A7C4A975E971) -> 9 bytes: 71 E9 75 A9 C4 A7 B5 E2 04
Imports System.Numerics

Module Example
   Dim bytes() As Byte
      
   Public Sub Main()
      Dim numbers() As BigInteger = { BigInteger.MinusOne, BigInteger.One, 
                                      BigInteger.Zero, 120, 128, 255, 1024, 
                                      Int64.MinValue, Int64.MaxValue, 
                                      BigInteger.Parse("90123123981293054321") }
      For Each number As BigInteger In numbers
         bytes = number.ToByteArray()
         Console.Write("{0} ({1}) -> ", number, number.ToString(GetSpecifier()))
         Console.Write("{0} bytes: ", bytes.Length)
         For Each byteValue As Byte In bytes
            Console.Write("{0:X2} ", byteValue)
         Next
         Console.WriteLine()
      Next   
   End Sub
   
   Private Function GetSpecifier() As String
      Return "X" + CStr(bytes.Length * 2)
   End Function
End Module
' The example displays the following output:
'    -1 (FF) -> 1 bytes: FF
'    1 (01) -> 1 bytes: 01
'    0 (00) -> 1 bytes: 00
'    120 (78) -> 1 bytes: 78
'    128 (0080) -> 2 bytes: 80 00
'    255 (00FF) -> 2 bytes: FF 00
'    1024 (0400) -> 2 bytes: 00 04
'    -9223372036854775808 (8000000000000000) -> 8 bytes: 00 00 00 00 00 00 00 80
'    9223372036854775807 (7FFFFFFFFFFFFFFF) -> 8 bytes: FF FF FF FF FF FF FF 7F
'    90123123981293054321 (04E2B5A7C4A975E971) -> 9 bytes: 71 E9 75 A9 C4 A7 B5 E2 04

Комментарии

Отдельные байты в массив, возвращаемый этим методом отображаются в прямом порядке.The individual bytes in the array returned by this method appear in little-endian order. То есть младшие байты значения предшествуют байты высокого порядка.That is, the lower-order bytes of the value precede the higher-order bytes. Первый байт в массиве отражает первые восемь бита BigInteger значение, второй байт отражает следующие восемь бит и т. д.The first byte of the array reflects the first eight bits of the BigInteger value, the second byte reflects the next eight bits, and so on. Например значение 1024 или 0x0400, хранится в виде следующий массив из двух байтов:For example, the value 1024, or 0x0400, is stored as the following array of two bytes:

ЭлементElement Байтовое значениеByte value
00 0x000x00
11 0x040x04

Отрицательные значения записываются в массиве, с использованием двух дополнением представления в компактной форме.Negative values are written to the array using two's complement representation in the most compact form possible. Например, -1 представляется как один байт, значение которого равно 0xFF вместо как массив, содержащий несколько элементов, таких как 0xFF, 0xFF или 0xFF, 0xFF, 0xFF, 0xFF.For example, -1 is represented as a single byte whose value is 0xFF instead of as an array with multiple elements, such as 0xFF, 0xFF or 0xFF, 0xFF, 0xFF, 0xFF.

Так как дополнение до двух представление всегда интерпретирует старший бит последнего байта в массиве (байт в позиции Array.Length - 1) как бит знака, метод возвращает массив байтов, в дополнительный элемент, значение которого равно нулю для устранить неоднозначность положительные значения, которые в противном случае может быть интерпретирован как с установленным битом знака.Because two's complement representation always interprets the highest-order bit of the last byte in the array (the byte at position Array.Length- 1) as the sign bit, the method returns a byte array with an extra element whose value is zero to disambiguate positive values that could otherwise be interpreted as having their sign bits set. Например, значение 120 или 0x78 представляется как массив однобайтовых: 0x78.For example, the value 120 or 0x78 is represented as a single-byte array: 0x78. Тем не менее, 128, или 0x80, представляется как массив размером 2 байта: 0x80, 0x00.However, 128, or 0x80, is represented as a two-byte array: 0x80, 0x00.

Вы можете приема-передачи BigInteger значение, сохранив его в массив байтов и восстановления с помощью BigInteger(Byte[]) конструктор.You can round-trip a BigInteger value by storing it to a byte array and then restoring it using the BigInteger(Byte[]) constructor.

Внимание!

Если код изменяет значение отдельных байтов в массиве, возвращенное этим методом, прежде чем он восстанавливает значение, необходимо убедиться в том, что вы не изменен знаковым битом.If your code modifies the value of individual bytes in the array returned by this method before it restores the value, you must make sure that you do not unintentionally change the sign bit. Например если ваши изменения увеличивают положительное значение, чтобы старший бит в последнем элементе массива байтов становится установленным, можно добавить новый байт, значение которого равно нулю, в конец массива.For example, if your modifications increase a positive value so that the highest-order bit in the last element of the byte array becomes set, you can add a new byte whose value is zero to the end of the array.

ToByteArray(Boolean, Boolean) ToByteArray(Boolean, Boolean) ToByteArray(Boolean, Boolean)

public byte[] ToByteArray (bool isUnsigned = false, bool isBigEndian = false);
member this.ToByteArray : bool * bool -> byte[]
Public Function ToByteArray (Optional isUnsigned As Boolean = false, Optional isBigEndian As Boolean = false) As Byte()

Параметры

Возвраты

Byte[]

Применяется к