Decoder Decoder Decoder Decoder Class

Definición

Convierte una secuencia de bytes codificados en un conjunto de caracteres.Converts a sequence of encoded bytes into a set of characters.

public ref class Decoder abstract
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Decoder
type Decoder = class
Public MustInherit Class Decoder
Herencia
DecoderDecoderDecoderDecoder
Atributos

Ejemplos

En el ejemplo siguiente se muestra el uso de un Decoder para convertir dos matrices de bytes diferentes en una matriz de caracteres.The following example demonstrates the use of a Decoder to convert two different byte arrays into a character array. Uno de los bytes de caracteres abarca las matrices.One of the character's bytes spans the arrays. Esto es similar a lo que un StreamReader objeto hace internamente cuando lee una secuencia.This is similar to what a StreamReader object does internally when reading a stream.

using namespace System;
using namespace System::Text;
int main()
{
   
   // These bytes in UTF-8 correspond to 3 different Unicode
   // characters: space (U+0020), # (U+0023), and the biohazard
   // symbol (U+2623).  Note the biohazard symbol requires 3 bytes
   // in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
   // multiple calls to GetChars, handling the case when one char
   // is in multiple byte arrays.
   array<Byte>^bytes1 = {0x20,0x23,0xe2};
   array<Byte>^bytes2 = {0x98,0xa3};
   array<Char>^chars = gcnew array<Char>(3);
   Decoder^ d = Encoding::UTF8->GetDecoder();
   int charLen = d->GetChars( bytes1, 0, bytes1->Length, chars, 0 );
   
   // The value of charLen should be 2 now.
   charLen += d->GetChars( bytes2, 0, bytes2->Length, chars, charLen );
   for ( UInt16 index(0); index < chars->Length; ++index )
   {
      Console::Write( "U+{0:X4}  ", static_cast<UInt16>(chars[ index ]) );

   }
}

using System;
using System.Text;
public class dec
{
    public static void Main()
    {
        // These bytes in UTF-8 correspond to 3 different Unicode
        // characters: space (U+0020), # (U+0023), and the biohazard
        // symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        // in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        // multiple calls to GetChars, handling the case when one char
        // is in multiple byte arrays.
        byte[] bytes1 = { 0x20, 0x23, 0xe2 };
        byte[] bytes2 = { 0x98, 0xa3 };
        char[] chars = new char[3];

        Decoder d = Encoding.UTF8.GetDecoder();
        int charLen = d.GetChars(bytes1, 0, bytes1.Length, chars, 0);
        // The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen);
        foreach(char c in chars)
            Console.Write("U+{0:X4}  ", (ushort)c);
    }
}
Imports System
Imports System.Text

Public Class dec
    
    Public Shared Sub Main()
        ' These bytes in UTF-8 correspond to 3 different Unicode
        ' characters: space (U+0020), # (U+0023), and the biohazard
        ' symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        ' in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        ' multiple calls to GetChars, handling the case when one char
        ' is in multiple byte arrays.
        Dim bytes1 As Byte() =  {&H20, &H23, &HE2}
        Dim bytes2 As Byte() =  {&H98, &HA3}
        Dim chars(3) As Char
        
        Dim d As Decoder = Encoding.UTF8.GetDecoder()
        Dim charLen As Integer = d.GetChars(bytes1, 0, bytes1.Length, chars, 0)
        ' The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen)
        Dim c As Char
        For Each c In  chars
            Console.Write("U+{0:X4}  ", Convert.ToUInt16(c) )
        Next c
    End Sub
End Class

Comentarios

Para obtener una instancia de una implementación de la Decoder (clase), la aplicación debe utilizar el GetDecoder método de un Encoding implementación.To obtain an instance of an implementation of the Decoder class, the application should use the GetDecoder method of an Encoding implementation.

El GetCharCount método determina el número de caracteres resultante de descodificar una secuencia de bytes y el GetChars método realiza la descodificación real.The GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars method performs the actual decoding. Hay varias versiones de estos dos métodos disponibles en la Decoder clase.There are several versions of both of these methods available in the Decoder class. Para obtener más información, vea Encoding.GetChars.For more information, see Encoding.GetChars. Un Decoder objeto mantiene información de estado entre las llamadas sucesivas a GetChars o Convert métodos de modo que puede descodificar correctamente las secuencias de bytes que abarcan distintos bloques.A Decoder object maintains state information between successive calls to GetChars or Convert methods so it can correctly decode byte sequences that span blocks. El Decoder también conserva los bytes al final de los bloques de datos y usa los bytes finales en la siguiente operación de descodificación.The Decoder also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Por lo tanto, GetDecoder y GetEncoder son útiles para las operaciones de transmisión y el archivo de red porque esas operaciones a menudo tratan con bloques de datos en lugar de un flujo de datos completa.Therefore, GetDecoder and GetEncoder are useful for network transmission and file operations because those operations often deal with blocks of data instead of a complete data stream.

Nota

Cuando la aplicación se realiza con un flujo de datos, debe asegurarse de que se vacíe la información de estado estableciendo el flush parámetro true en la llamada al método apropiado.When the application is done with a stream of data, it should make sure that the state information is flushed by setting the flush parameter to true in the appropriate method call. Si se produce una excepción o si la aplicación modifica los flujos, debe llamar a Reset para borrar el estado interno de la Decoder objeto.If an exception occurs or if the application switches streams, it should call Reset to clear the internal state of the Decoder object.

Consideraciones sobre la versiónVersion Considerations

Un Decoder o Encoder se puede serializar el objeto durante una operación de conversión.A Decoder or Encoder object can be serialized during a conversion operation. El estado del objeto se conserva si se ha deserializado en la misma versión de .NET Framework, pero se pierden si se deserializa en otra versión.The state of the object is retained if it is deserialized in the same version of the .NET Framework, but lost if it is deserialized in another version.

Notas a los desarrolladores de herederos

Cuando la aplicación se hereda de esta clase, deben invalidar a todos los miembros.When your application inherits from this class, it must override all the members.

Constructores

Decoder() Decoder() Decoder() Decoder()

Inicializa una nueva instancia de la clase Decoder.Initializes a new instance of the Decoder class.

Propiedades

Fallback Fallback Fallback Fallback

Obtiene o establece un objeto DecoderFallback para el objeto Decoder actual.Gets or sets a DecoderFallback object for the current Decoder object.

FallbackBuffer FallbackBuffer FallbackBuffer FallbackBuffer

Obtiene el objeto DecoderFallbackBuffer asociado al objeto Decoder actual.Gets the DecoderFallbackBuffer object associated with the current Decoder object.

Métodos

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

Convierte un búfer de bytes codificados en caracteres con codificación UTF-16 y almacena el resultado en otro búfer.Converts a buffer of encoded bytes to UTF-16 encoded characters and stores the result in another buffer.

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

Convierte una matriz de bytes codificados en caracteres con codificación UTF-16 y almacena el resultado en otra matriz de caracteres.Converts an array of encoded bytes to UTF-16 encoded characters and stores the result in a character array.

Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes a partir del puntero de bytes especificado.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.A parameter indicates whether to clear the internal state of the decoder after the calculation.

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

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

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

Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. Un parámetro indica si se debe borrar el estado interno del descodificador después del cálculo.A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean)
GetChars(Byte*, Int32, Char*, Int32, Boolean) GetChars(Byte*, Int32, Char*, Int32, Boolean) GetChars(Byte*, Int32, Char*, Int32, Boolean) 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.When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer and any bytes in the internal buffer into a set of characters that are stored starting at the specified character pointer. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.A parameter indicates whether to clear the internal state of the decoder after the conversion.

GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) 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.When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array.

GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) 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.When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array. Un parámetro indica si el estado interno del descodificador se borra después de la conversión.A parameter indicates whether to clear the internal state of the decoder after the conversion.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Reset() Reset() Reset() Reset()

Cuando se reemplaza en una clase derivada, reestablece el estado inicial del descodificador.When overridden in a derived class, sets the decoder back to its initial state.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: