ASCIIEncoding.GetChars Método

Definição

Espaço de Nomes:
System.Text
Assemblagens:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Text.Encoding.Extensions.dll
Assemblagem:
netstandard.dll

Descodifica uma sequência de bytes num conjunto de caracteres.

Sobrecargas

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

Decodifica uma sequência de bytes a partir do ponteiro de byte especificado num conjunto de caracteres que são armazenados a partir do ponteiro especificado.
GetChars(Byte[], Int32, Int32, Char[], Int32)

Descodifica uma sequência de bytes do array de bytes especificado para o array de caracteres especificado.

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

Importante

Esta API não está em conformidade com CLS.

Alternativa em conformidade com CLS
System.Text.ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)

Decodifica uma sequência de bytes a partir do ponteiro de byte especificado num conjunto de caracteres que são armazenados a partir do ponteiro especificado.

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)]
[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)]
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)>]
[<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
[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Parâmetros

bytes
Byte*

Um apontador para o primeiro byte a descodificar.

byteCount
Int32

O número de bytes a descodificar.

chars
Char*

Um indicador para o local onde começar a escrever o conjunto resultante de caracteres.

charCount
Int32

O número máximo de caracteres para escrever.

Devoluções

Int32

O número real de caracteres escritos no local indicado por chars.

Atributos
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Exceções

ArgumentNullException

bytes é null.

-ou-

chars é null.

ArgumentOutOfRangeException

byteCount ou charCount é inferior a zero.

ArgumentException

charCount é inferior ao número resultante de caracteres.

DecoderFallbackException

Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)

- e -

DecoderFallback está definido como DecoderExceptionFallback.

Observações

Para calcular o tamanho exato do array necessário GetChars para armazenar os caracteres resultantes, a aplicação utiliza GetCharCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxCharCount. O GetCharCount método geralmente permite a alocação de menos memória, enquanto o GetMaxCharCount método geralmente é executado mais rapidamente.

Os dados a converter, como dados lidos de um fluxo, só podem estar disponíveis em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, a aplicação deve usar o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

ASCIIEncoding não fornece deteção de erros. Qualquer byte maior que o 0x7F hexadecimal é decodificado como o ponto de interrogação Unicode ("?").

Atenção

Por razões de segurança, recomenda-se que a sua aplicação use UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ative a deteção de erros.

Ver também

Aplica-se a

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

Descodifica uma sequência de bytes do array de bytes especificado para o array de caracteres especificado.

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

Parâmetros

bytes
Byte[]

O array de bytes que contém a sequência de bytes a decodificar.

byteIndex
Int32

O índice do primeiro byte a descodificar.

byteCount
Int32

O número de bytes a descodificar.

chars
Char[]

O array de caracteres para conter o conjunto resultante de caracteres.

charIndex
Int32

O índice a partir do qual começar a escrever o conjunto resultante de caracteres.

Devoluções

Int32

O número real de caracteres escritos em chars.

Exceções

ArgumentNullException

bytes é null.

-ou-

chars é null.

ArgumentOutOfRangeException

byteIndex ou byteCount ou charIndex é menor que zero.

-ou-

byteIndex e byteCount não denotam um intervalo válido em bytes.

-ou-

charIndex não é um índice válido em chars.

ArgumentException

chars não tem capacidade suficiente de charIndex até ao fim do array para acomodar os caracteres resultantes.

DecoderFallbackException

Ocorreu um recurso de recurso (para mais informações, veja Codificação de Caracteres em .NET)

- e -

DecoderFallback está definido como DecoderExceptionFallback.

Exemplos

O exemplo seguinte demonstra como descodificar um conjunto de elementos de um array de bytes e armazenar o resultado num conjunto de elementos num array de caracteres Unicode.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();

        int charCount = ascii.GetCharCount(bytes, 6, 8);
        chars = new Char[charCount];
        int charsDecodedCount = ascii.GetChars(bytes, 6, 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 ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}

        Dim ascii As New ASCIIEncoding()

        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 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

Observações

Para calcular o tamanho exato do array necessário GetChars para armazenar os caracteres resultantes, a aplicação utiliza GetCharCount. Para calcular o tamanho máximo do array, a aplicação deve usar GetMaxCharCount. O GetCharCount método geralmente permite a alocação de menos memória, enquanto o GetMaxCharCount método geralmente é executado mais rapidamente.

Os dados a converter, como dados lidos de um fluxo, só podem estar disponíveis em blocos sequenciais. Neste caso, ou se a quantidade de dados for tão grande que precisa de ser dividida em blocos mais pequenos, a aplicação deve usar o Decoder ou o Encoder fornecido pelo GetDecoder método ou pelo GetEncoder método, respetivamente.

ASCIIEncoding não fornece deteção de erros. Qualquer byte maior que o 0x7F hexadecimal é decodificado como o ponto de interrogação Unicode ("?").

Atenção

Por razões de segurança, recomenda-se que a sua aplicação use UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ative a deteção de erros.

Ver também

Aplica-se a