Encoding.GetEncoder Méthode

Définition

En cas de substitution dans une classe dérivée, obtient un encodeur qui convertit une séquence de caractères Unicode en séquence codée d’octets.

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

Retours

Qui Encoder convertit une séquence de caractères Unicode en séquence codée d’octets.

Remarques

La Encoder.GetBytes méthode convertit les blocs séquentiels de caractères en blocs séquentiels d’octets, de manière similaire à la GetBytes méthode de cette classe. Toutefois, une Encoder information d’état entre les appels permet d’encoder correctement les séquences de caractères qui s’étendent sur des blocs. Il Encoder conserve également les caractères de fin à la fin des blocs de données et utilise les caractères de fin dans l’opération d’encodage suivante. Par exemple, un bloc de données peut se terminer par une substitution élevée sans correspondance, et la substitution faible correspondante peut se trouver dans le bloc de données suivant. Par conséquent, GetDecoder et GetEncoder sont utiles pour les opérations de transmission et de fichier réseau, car ces opérations traitent souvent des blocs de données au lieu d’un flux de données complet.

Notes pour les héritiers

L’implémentation par défaut retourne un Encoder qui appelle les méthodes et GetBytes(Char[]) les GetByteCount(Char[]) méthodes de l’actuel Encoding. Vous devez remplacer cette méthode pour retourner un Encoder état qui conserve son état entre les appels.

S’applique à

Voir aussi