UTF7Encoding.GetChars Метод

Определение

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

Перегрузки

GetChars(Byte*, Int32, Char*, Int32)

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

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

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

GetChars(Byte*, Int32, Char*, Int32)

Важно!

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

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

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

Параметры

bytes
Byte*

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

byteCount
Int32

Число байтов для декодирования.

chars
Char*

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

charCount
Int32

Наибольшее количество символов для записи.

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

Int32

Фактическое число символов, записанных в местоположение, указанное с помощью параметра chars.

Атрибуты

Исключения

bytes имеет значение null (Nothing).

-или- chars имеет значение null (Nothing).

Значение параметра byteCount или charCount меньше нуля.

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

Произошел откат (см. сведения о кодировке символов в .NET)

Комментарии

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

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

Примечание

UTF7Encoding не обеспечивает обнаружение ошибок. При обнаружении UTF7Encoding недопустимых байтов обычно выдает недопустимые байты. Если байт больше шестнадцатеричного 0x7F, байтовое значение равно нулю в символ Юникода, результат сохраняется в массиве chars , а любая последовательность сдвигов завершается. Например, если кодируемый байт является шестнадцатеричным 0x81, результирующий символ — U+0081. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включать обнаружение ошибок.

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

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

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

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

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

Параметры

bytes
Byte[]

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

byteIndex
Int32

Индекс первого декодируемого байта.

byteCount
Int32

Число байтов для декодирования.

chars
Char[]

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

charIndex
Int32

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

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

Int32

Фактическое число символов, записанных в chars.

Исключения

bytes имеет значение null (Nothing).

-или- chars имеет значение null (Nothing).

Значение параметра byteIndex, byteCount или charIndex меньше нуля.

-или- Параметрыbyteindex и byteCount не указывают допустимый диапазон в bytes.

-или- Значение параметра charIndex не является допустимым индексом в chars.

Недостаточно емкости chars от charIndex до конца массива для размещения полученных символов.

Произошел откат (см. сведения о кодировке символов в .NET)

Примеры

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

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,84,70,55,32,69,110,99,111,100,105,110,103,32,69,120,97,109,112,108,101};
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = utf7->GetCharCount( bytes, 2, 8 );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = utf7->GetChars( bytes, 2, 8, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}
using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.GetChars(bytes, 2, 8, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}
Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.GetChars(bytes, 2, 8, chars, 0)
        
        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Комментарии

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

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

Примечание

UTF7Encoding не обеспечивает обнаружение ошибок. При обнаружении UTF7Encoding недопустимых байтов обычно выдает недопустимые байты. Если байт больше шестнадцатеричного 0x7F, байтовое значение равно нулю в символ Юникода, результат сохраняется в массиве chars , а любая последовательность сдвигов завершается. Например, если кодируемый байт является шестнадцатеричным 0x81, результирующий символ — U+0081. По соображениям безопасности приложения рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включать обнаружение ошибок.

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

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