Decoder.GetChars Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Ensamblado:

netstandard.dll

Ensamblado:

mscorlib.dll

Ensamblado:

System.Text.Encoding.dll

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes en un juego de caracteres.

Sobrecargas

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)	Cuando se invalida en una clase derivada, descodifica una secuencia de bytes de intervalo y cualquier byte del búfer interno en un juego de caracteres que se almacena a partir del puntero de caracteres especificado. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.
GetChars(Byte*, Int32, Char*, Int32, Boolean)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes a partir del puntero de byte especificado y cualquier byte del búfer interno en un juego de caracteres que se almacena a partir del puntero de caracteres especificado. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier byte del búfer interno en la matriz de caracteres especificada.
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier byte del búfer interno en la matriz de caracteres especificada. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)

Cuando se invalida en una clase derivada, descodifica una secuencia de bytes de intervalo y cualquier byte del búfer interno en un juego de caracteres que se almacena a partir del puntero de caracteres especificado. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.

public:
 virtual int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars, bool flush);

public virtual int GetChars (ReadOnlySpan<byte> bytes, Span<char> chars, bool flush);

abstract member GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int
override this.GetChars : ReadOnlySpan<byte> * Span<char> * bool -> int

Public Overridable Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char), flush As Boolean) As Integer

Parámetros

bytes

ReadOnlySpan<Byte>

Un intervalo de bytes que se va a descodificar.

chars

Span<Char>

Un intervalo en el que se va a escribir el juego de caracteres resultante.

flush

Boolean

Es true para borrar el estado interno del descodificador después de la conversión; de lo contrario, es false.

Devoluciones

Int32

El número real de caracteres escritos en el intervalo indicado por el parámetro chars.

Comentarios

Recuerde que el Decoder objeto guarda el estado entre las llamadas a GetChars . Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro en para asegurarse de que se vacía la información flush true de estado. Con esta configuración, el descodificador omite los bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño de intervalo exacto GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el Convert método . GetChars producirá una excepción si el intervalo de salida no es lo suficientemente grande, pero rellenará tanto espacio como sea posible y devolverá los bytes leídos y los caracteres escritos, siempre que la matriz de salida permita al menos dos Convert caracteres. Consulte también el Encoding.GetChars tema para obtener más comentarios.

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

Importante

Esta API no es conforme a CLS.

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes a partir del puntero de byte especificado y cualquier byte del búfer interno en un juego de caracteres que se almacena a partir del puntero de caracteres especificado. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.

public:
 virtual int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetChars (byte* bytes, int byteCount, char* chars, int charCount, bool flush);

[<System.CLSCompliant(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int * bool -> int

Parámetros

bytes

Byte*

Puntero al primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char*

Puntero a la ubicación en la que se iniciará la escritura del juego de caracteres resultante.

charCount

Int32

Número máximo de caracteres que se van a escribir.

flush

Boolean

Es true para borrar el estado interno del descodificador después de la conversión; de lo contrario, es false.

Devoluciones

Int32

Número real de caracteres escritos en la ubicación indicada por el parámetro chars.

Atributos

CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Excepciones

ArgumentNullException

bytes es null (Nothing).

O bien

chars es null (Nothing).

ArgumentOutOfRangeException

byteCount o charCount es menor que cero.

ArgumentException

El valor de charCount es menor que el número de caracteres resultante.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Comentarios

Recuerde que el Decoder objeto guarda el estado entre las llamadas a GetChars . Cuando la aplicación se realiza con un flujo de datos, debe establecer el parámetro en para asegurarse de que se vacía la información flush true de estado. Con esta configuración, el descodificador omite los bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto del búfer GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el Convert método . GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero rellenará el máximo espacio posible y devolverá los bytes leídos y los caracteres escritos, siempre que la matriz de salida permita al menos dos Convert caracteres. Consulte también el Encoding.GetChars tema para obtener más comentarios.

Consulte también

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

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

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier byte del búfer interno en la matriz de caracteres especificada.

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

abstract member GetChars : byte[] * int * int * char[] * int -> int

Public MustOverride Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parámetros

bytes

Byte[]

Matriz de bytes que contiene la secuencia de bytes que se va a descodificar.

byteIndex

Int32

Índice del primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char[]

Matriz de caracteres que contendrá el juego de caracteres resultante.

charIndex

Int32

Índice en el que se inicia la escritura del juego de caracteres resultante.

Devoluciones

Int32

Número real de caracteres escritos en chars.

Excepciones

ArgumentNullException

bytes es null (Nothing).

O bien

chars es null (Nothing).

ArgumentOutOfRangeException

El valor de byteIndex, byteCount o charIndex es menor que cero.

O bien

byteindex y byteCount no denotan un intervalo válido en bytes.

O bien

charIndex no es un índice válido para chars.

ArgumentException

chars no tiene suficiente capacidad desde charIndex hasta el final de la matriz para aloja los caracteres resultantes.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Ejemplos

En el ejemplo siguiente se muestra cómo descodificar un intervalo de elementos de una matriz de bytes y almacenarlos en una matriz de caracteres Unicode. El GetCharCount método se usa para calcular el número de caracteres necesarios para almacenar los elementos descodificados en la matriz bytes . El método descodifica los elementos especificados en GetChars la matriz de bytes y los almacena en la nueva matriz de caracteres.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = uniDecoder->GetChars( bytes, 0, bytes->Length, 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();
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, 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();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, 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

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Comentarios

Recuerde que el Decoder objeto guarda el estado entre las llamadas a GetChars . Cuando la aplicación se completa con un flujo de datos, debe establecer el parámetro en para asegurarse de que se vacía flush true la información de estado. Con esta configuración, el descodificador omite los bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto de la matriz GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el Convert método . GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero rellenará el máximo espacio posible y devolverá los bytes leídos y los caracteres escritos, siempre que la matriz de salida permita al menos dos Convert caracteres. Consulte también el Encoding.GetChars tema para obtener más comentarios.

Consulte también

• GetCharCount(Byte[], Int32, Int32)
• Reset()

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

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada y cualquier byte del búfer interno en la matriz de caracteres especificada. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);

public virtual int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);

abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int

Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Parámetros

bytes

Byte[]

Matriz de bytes que contiene la secuencia de bytes que se va a descodificar.

byteIndex

Int32

Índice del primer byte que se va a descodificar.

byteCount

Int32

Número de bytes que se van a descodificar.

chars

Char[]

Matriz de caracteres que contendrá el juego de caracteres resultante.

charIndex

Int32

Índice en el que se inicia la escritura del juego de caracteres resultante.

flush

Boolean

Es true para borrar el estado interno del descodificador después de la conversión; de lo contrario, es false.

Devoluciones

Int32

Número real de caracteres escrito en el parámetro chars.

Excepciones

ArgumentNullException

bytes es null (Nothing).

O bien

chars es null (Nothing).

ArgumentOutOfRangeException

El valor de byteIndex, byteCount o charIndex es menor que cero.

O bien

byteindex y byteCount no denotan un intervalo válido en bytes.

O bien

charIndex no es un índice válido para chars.

ArgumentException

chars no tiene suficiente capacidad desde charIndex hasta el final de la matriz para aloja los caracteres resultantes.

DecoderFallbackException

Se ha producido una reserva (para más información, vea Codificación de caracteres en .NET)

• y -

El valor de Fallback está establecido en DecoderExceptionFallback.

Comentarios

Recuerde que el Decoder objeto guarda el estado entre las llamadas a GetChars . Cuando la aplicación se completa con un flujo de datos, debe establecer el parámetro en para asegurarse de que se vacía flush true la información de estado. Con esta configuración, el descodificador omite los bytes no válidos al final del bloque de datos y borra el búfer interno.

Para calcular el tamaño exacto de la matriz GetChars que requiere almacenar los caracteres resultantes, la aplicación debe usar GetCharCount .

Si se llama a con establecido en , el descodificador almacena los bytes finales al final del bloque de datos en un búfer interno y los usa en la siguiente operación GetChars flush de false descodificación. La aplicación debe llamar a en un bloque de datos inmediatamente antes de llamar a en el mismo bloque, de modo que los bytes finales del bloque anterior se GetCharCount GetChars incluyan en el cálculo.

Si la aplicación va a convertir muchos segmentos de un flujo de entrada, considere la posibilidad de usar el Convert método . GetChars producirá una excepción si el búfer de salida no es lo suficientemente grande, pero rellenará el máximo espacio posible y devolverá los bytes leídos y los caracteres escritos, siempre que la matriz de salida permita al menos dos Convert caracteres. Consulte también el Encoding.GetChars tema para obtener más comentarios.

Consulte también

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()