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

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, uma Encoder mantém informações de estado entre chamadas para codificar corretamente sequências de caracteres que abrangem blocos. O Encoder também preserva 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 sem correspondência e o substituto baixo correspondente pode estar no próximo bloco de dados. Portanto, GetDecoder e GetEncoder são úteis para operações de transmissão de rede e arquivos, 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 métodos e GetBytes(Char[]) os GetByteCount(Char[]) métodos do atualEncoding. Você deve substituir esse método para retornar um Encoder que mantém seu estado entre chamadas.

Aplica-se a

Confira também