Encoding.GetEncoder Método

Definição

Quando sobrescrito numa classe derivada, obtém-se um codificador que converte uma sequência de caracteres Unicode numa sequência 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

Devoluções

A Encoder que converte uma sequência de caracteres Unicode numa sequência codificada de bytes.

Observações

O Encoder.GetBytes método converte blocos sequenciais de caracteres em blocos sequenciais de bytes, de forma semelhante ao GetBytes método desta classe. No entanto, a Encoder mantém a informação de estado entre chamadas para codificar corretamente sequências de caracteres que abrangem blocos. Também Encoder preserva os caracteres finais no final dos blocos de dados e utiliza os caracteres finais na próxima operação de codificação. Por exemplo, um bloco de dados pode terminar com um substituto alto não emparelhado, e o substituto baixo correspondente pode estar no bloco de dados seguinte. Portanto, GetDecoder e GetEncoder são úteis para transmissão em rede e operações de ficheiros, porque essas operações frequentemente lidam com blocos de dados em vez de um fluxo de dados completo.

Notas para Herdeiros

A implementação padrão devolve um Encoder que chama os GetByteCount(Char[]) métodos e GetBytes(Char[]) do atual Encoding. Deve sobrescrever este método para devolver um Encoder que mantenha o seu estado entre chamadas.

Aplica-se a

Ver também