Encoding.GetEncoder Método

Definición

Cuando se reemplaza en una clase derivada, obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia codificada de bytes.

public:
 virtual System::Text::Encoder ^ GetEncoder();
public virtual System.Text.Encoder GetEncoder();
abstract member GetEncoder : unit -> System.Text.Encoder
override this.GetEncoder : unit -> System.Text.Encoder
Public Overridable Function GetEncoder () As Encoder

Devoluciones

que Encoder convierte una secuencia de caracteres Unicode en una secuencia codificada de bytes.

Comentarios

El Encoder.GetBytes método convierte bloques secuenciales de caracteres en bloques secuenciales de bytes, de forma similar al GetBytes método de esta clase. Sin embargo, un Encoder mantiene información de estado entre llamadas para codificar correctamente secuencias de caracteres que abarcan bloques. Encoder También conserva los caracteres finales al final de los bloques de datos y usa los caracteres finales en la siguiente operación de codificación. Por ejemplo, un bloque de datos podría terminar con un suplente alto no coincidente y el suplente bajo coincidente podría estar en el siguiente bloque de datos. Por lo tanto, GetDecoder y GetEncoder son útiles para las operaciones de transmisión de red y archivos, ya que esas operaciones suelen tratar con bloques de datos en lugar de un flujo de datos completo.

Notas a los desarrolladores de herederos

La implementación predeterminada devuelve un Encoder objeto que llama a los GetByteCount(Char[]) métodos y GetBytes(Char[]) del objeto actual Encoding. Debe invalidar este método para devolver un Encoder que mantenga su estado entre las llamadas.

Se aplica a

Consulte también