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.When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of 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.A Encoder that converts a sequence of Unicode characters into an encoded sequence of 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.The Encoder.GetBytes method converts sequential blocks of characters into sequential blocks of bytes, in a manner similar to the GetBytes method of this class. No entanto, um Encoder mantém informações de estado entre chamadas, de modo que codifica corretamente Sequências de caracteres que abrangem blocos.However, a Encoder maintains state information between calls so it correctly encodes character sequences that span blocks. 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.The Encoder also preserves trailing characters at the end of data blocks and uses the trailing characters in the next encoding operation. 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.For example, a data block might end with an unmatched high surrogate, and the matching low surrogate might be in the next data block. 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.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.

Notas aos Herdeiros

A implementação padrão retorna um Encoder que chama os GetByteCount(Char[]) GetBytes(Char[]) métodos e do atual Encoding .The default implementation returns a Encoder that calls the GetByteCount(Char[]) and GetBytes(Char[]) methods of the current Encoding. Você deve substituir esse método para retornar um Encoder que mantém seu estado entre chamadas.You must override this method to return a Encoder that maintains its state between calls.

Aplica-se a

Confira também