Encoding.GetEncoder Metodo

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

Valori restituiti

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

Commenti

Il Encoder.GetBytes metodo converte blocchi sequenziali di caratteri in blocchi sequenziali di byte, in modo simile al GetBytes metodo di questa classe. Tuttavia, un oggetto Encoder mantiene le informazioni sullo stato tra le chiamate in modo che codifica correttamente le sequenze di caratteri che si estendono su blocchi. Encoder Mantiene inoltre i caratteri finali alla fine dei blocchi di dati e usa i caratteri finali nell'operazione di codifica successiva. Ad esempio, un blocco di dati potrebbe terminare con un surrogato elevato non corrispondente 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 i GetByteCount(Char[]) metodi e GetBytes(Char[]) dell'oggetto corrente Encoding. È necessario eseguire l'override di questo metodo per restituire un Encoder oggetto che mantiene lo stato tra le chiamate.

Vedi anche

• Encoder
• GetBytes(Char[])
• GetByteCount(Char[])
• GetDecoder()
• Come usare le classi di codifica dei caratteri in .NET