UnicodeEncoding.GetBytes Метод

Определение

Пространство имен:
System.Text
Сборки:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Сборки:
netstandard.dll, System.Text.Encoding.Extensions.dll
Сборка:
System.Text.Encoding.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Кодирует набор символов в последовательность байтов.

Перегрузки

Имя Описание
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Кодирует набор символов из указанного массива символов в указанный массив байтов.
GetBytes(String, Int32, Int32, Byte[], Int32)

Кодирует набор символов из указанного в указанный String массив байтов.
GetBytes(String)

Кодирует набор символов из указанной строки в указанный массив байтов.
GetBytes(Char*, Int32, Byte*, Int32)

Кодирует набор символов, начиная с указанного указателя символов, в последовательность байтов, хранящихся начиная с указанного указателя байтов.

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs

Кодирует набор символов из указанного массива символов в указанный массив байтов.

public:
 override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes(char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : char[] * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Параметры

chars
Char[]

Массив символов, содержащий набор символов для кодирования.

charIndex
Int32

Индекс первого символа для кодирования.

charCount
Int32

Число символов для кодирования.

bytes
Byte[]

Массив байтов, содержащий результирующий последовательность байтов.

byteIndex
Int32

Индекс, с которого начинается запись результирующей последовательности байтов.

Возвращаемое значение

Int32

Фактическое число байтов, записанных в bytes.

Исключения

ArgumentNullException

chars is null (Nothing).

–или–

bytes is null (Nothing).

ArgumentOutOfRangeException

charIndex или charCountbyteIndex меньше нуля.

–или–

charIndex и charCount не обозначайте допустимый диапазон в chars.

–или–

byteIndex не является допустимым индексом в bytes.

ArgumentException

Обнаружение ошибок включено и chars содержит недопустимую последовательность символов.

–или–

bytes не имеет достаточной емкости от byteIndex конца массива для размещения результирующего байта.

EncoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

EncoderFallback задан как EncoderExceptionFallback.

Примеры

В следующем примере показано, как использовать GetBytes метод для кодирования диапазона символов из String байтов и хранения закодированных байтов в диапазоне элементов в массиве байтов.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "Unicode Encoding Example";
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars.ToCharArray(), 8, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 8, 8, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "Unicode Encoding Example"
        
        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars.ToCharArray(), 8, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 8, 8, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, необходимый GetBytes для хранения результирующего байта, вызывается GetByteCount метод. Чтобы вычислить максимальный размер массива GetMaxByteCount , вызовите метод. Метод GetByteCount обычно выделяет меньше памяти, а GetMaxByteCount метод обычно выполняется быстрее.

При обнаружении ошибок недопустимая последовательность приводит к возникновению ArgumentExceptionэтого метода. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не возникает.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder или Encoder предоставленный GetDecoder методом GetEncoder соответственно.

Important

Чтобы убедиться, что кодированные байты декодируются должным образом при сохранении в виде файла или в виде потока, можно префиксировать поток закодированных байтов с предварительной записью. Вставка преамблирования в начале потока байтов (например, в начале ряда байтов, записываемых в файл), является ответственностью разработчика. Метод GetBytes не добавляет преамблирование к началу последовательности закодированных байтов.

См. также раздел

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

GetBytes(String, Int32, Int32, Byte[], Int32)

Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs

Кодирует набор символов из указанного в указанный String массив байтов.

public:
 override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes(string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Параметры

s
String

Строка, содержащая набор символов для кодирования.

charIndex
Int32

Индекс первого символа для кодирования.

charCount
Int32

Число символов для кодирования.

bytes
Byte[]

Массив байтов, содержащий результирующий последовательность байтов.

byteIndex
Int32

Индекс, с которого начинается запись результирующей последовательности байтов.

Возвращаемое значение

Int32

Фактическое число байтов, записанных в bytes.

Исключения

ArgumentNullException

s равно null.

–или–

bytes is null (Nothing).

ArgumentOutOfRangeException

charIndex или charCountbyteIndex меньше нуля.

–или–

charIndex и charCount не обозначайте допустимый диапазон в s.

–или–

byteIndex не является допустимым индексом в bytes.

ArgumentException

Обнаружение ошибок включено и s содержит недопустимую последовательность символов.

–или–

bytes не имеет достаточной емкости от byteIndex конца массива для размещения результирующего байта.

EncoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

EncoderFallback задан как EncoderExceptionFallback.

Примеры

В следующем примере показано, как кодировать диапазон элементов из массива символов Юникода и хранить закодированные байты в диапазоне элементов в массиве байтов.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 1, 2, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte

        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 1, 2, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, необходимый GetBytes для хранения результирующего байта, вызывается GetByteCount метод. Чтобы вычислить максимальный размер массива GetMaxByteCount , вызовите метод. Метод GetByteCount обычно выделяет меньше памяти, а GetMaxByteCount метод обычно выполняется быстрее.

При обнаружении ошибок недопустимая последовательность приводит к возникновению ArgumentExceptionэтого метода. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не возникает.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder или Encoder предоставленный GetDecoder методом GetEncoder соответственно.

Important

Чтобы убедиться, что кодированные байты декодируются должным образом при сохранении в виде файла или в виде потока, можно префиксировать поток закодированных байтов с предварительной записью. Вставка преамблирования в начале потока байтов (например, в начале ряда байтов, записываемых в файл), является ответственностью разработчика. Метод GetBytes не добавляет преамблирование к началу последовательности закодированных байтов.

См. также раздел

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

GetBytes(String)

Кодирует набор символов из указанной строки в указанный массив байтов.

public:
 override cli::array <System::Byte> ^ GetBytes(System::String ^ s);
public override byte[] GetBytes(string s);
override this.GetBytes : string -> byte[]
Public Overrides Function GetBytes (s As String) As Byte()

Параметры

s
String

Возвращаемое значение

Byte[]

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

GetBytes(Char*, Int32, Byte*, Int32)

Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs

Внимание

Этот API несовместим с CLS.

Кодирует набор символов, начиная с указанного указателя символов, в последовательность байтов, хранящихся начиная с указанного указателя байтов.

public:
 override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);
[System.CLSCompliant(false)]
public override int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes(char* chars, int charCount, byte* bytes, int byteCount);
[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Параметры

chars
Char*

Указатель на первый символ для кодирования.

charCount
Int32

Число символов для кодирования.

bytes
Byte*

Указатель на расположение, с которого начинается запись результирующей последовательности байтов.

byteCount
Int32

Максимальное число байтов для записи.

Возвращаемое значение

Int32

Фактическое число байтов, записанных в расположении, указанном параметром bytes .

Атрибуты
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Исключения

ArgumentNullException

chars is null (Nothing).

–или–

bytes is null (Nothing).

ArgumentOutOfRangeException

charCount или byteCount меньше нуля.

ArgumentException

Обнаружение ошибок включено и chars содержит недопустимую последовательность символов.

–или–

byteCount меньше результирующего числа байтов.

EncoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

EncoderFallback задан как EncoderExceptionFallback.

Комментарии

Чтобы вычислить точный размер массива, который GetBytes требует хранения результирующего байта, вызывается GetByteCount метод. Чтобы вычислить максимальный размер массива GetMaxByteCount , вызовите метод. Метод GetByteCount обычно выделяет меньше памяти, а GetMaxByteCount метод обычно выполняется быстрее.

При обнаружении ошибок недопустимая последовательность приводит к возникновению ArgumentExceptionэтого метода. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не возникает.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder объект или EncoderGetDecoder объект, предоставленный методом GetEncoder соответственно.

Important

Чтобы убедиться, что кодированные байты декодируются должным образом при сохранении в виде файла или в виде потока, можно префиксировать поток закодированных байтов с предварительной записью. Вставка преамблирования в начале потока байтов (например, в начале ряда байтов, записываемых в файл), является ответственностью разработчика. Метод GetBytes не добавляет преамблирование к началу последовательности закодированных байтов.

См. также раздел

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