Compartilhar via


Encoding.GetEncoder Método

Definição

Quando substituído em uma classe derivada, obtém um codificador que converte uma sequência de caracteres Unicode em uma 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

Retornos

Encoder

Um Encoder que converte uma sequência de caracteres Unicode em uma sequência codificada de bytes.

Comentários

O Encoder.GetBytes método converte blocos sequenciais de caracteres em blocos sequenciais de bytes, de maneira semelhante ao GetBytes método dessa classe. No entanto, um Encoder mantém informações de estado entre chamadas, de modo que codifica corretamente Sequências de caracteres que abrangem blocos. O Encoder também preserva os caracteres à direita no final dos blocos de dados e usa os caracteres à direita na próxima operação de codificação. Por exemplo, um bloco de dados pode terminar com um substituto alto inigualável e o substituto baixo correspondente pode estar no próximo bloco de dados. Portanto, GetDecoder e GetEncoder são úteis para a transmissão de rede e operações de arquivo, pois essas operações geralmente lidam com blocos de dados em vez de um fluxo de dados completo.

Notas aos Herdeiros

A implementação padrão retorna um Encoder que chama os GetByteCount(Char[]) GetBytes(Char[]) métodos e do atual Encoding . Você deve substituir esse método para retornar um Encoder que mantém seu estado entre chamadas.

Aplica-se a

Confira também