Condividi tramite


Encoding.GetEncoder Metodo

Definizione

Quando ne viene eseguito l'override in una classe derivata, ottiene un codificatore che converte una sequenza di caratteri Unicode in una sequenza di byte codificata.

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

Restituisce

Encoder

Oggetto Encoder che converte una sequenza di caratteri Unicode in una sequenza di byte codificata.

Commenti

Il Encoder.GetBytes metodo converte blocchi sequenziali di caratteri in blocchi sequenziali di byte, in modo analogo al GetBytes metodo di questa classe. Tuttavia, un oggetto Encoder mantiene le informazioni sullo stato tra le chiamate in modo da codificare correttamente le sequenze di caratteri che si estendono a blocchi. EncoderConserva inoltre i caratteri finali alla fine dei blocchi di dati e utilizza i caratteri finali nella successiva operazione di codifica. Un blocco di dati, ad esempio, può terminare con un surrogato alto senza corrispondenza e il surrogato basso corrispondente potrebbe trovarsi nel blocco di dati successivo. Pertanto, GetDecoder e GetEncoder sono utili per le operazioni di trasmissione e file di rete, perché tali operazioni spesso gestiscono blocchi di dati anziché un flusso di dati completo.

Note per gli eredi

L'implementazione predefinita restituisce un oggetto Encoder che chiama GetByteCount(Char[]) i GetBytes(Char[]) metodi e dell'oggetto corrente Encoding . È necessario eseguire l'override di questo metodo per restituire un oggetto Encoder che mantiene lo stato tra le chiamate.

Si applica a

Vedi anche