Encoding.GetEncoder Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 d'octets encodée.
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
Encoder qui convertit une séquence de caractères Unicode en séquence d'octets encodée.
Remarques
La Encoder.GetBytes méthode convertit des blocs de caractères séquentiels en blocs séquentiels d’octets, de la même façon que la GetBytes méthode de cette classe. Toutefois, un Encoder gère les informations d’État entre les appels afin d’encoder correctement les séquences de caractères qui s’étendent sur des blocs. Le 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 un substitut étendu sans correspondance, et le substitut faible correspondant peut se trouver dans le bloc de données suivant. Par conséquent, GetDecoder et GetEncoder sont utiles pour la transmission réseau et les opérations de fichier, 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 GetByteCount(Char[]) les GetBytes(Char[]) méthodes et du actuel Encoding . Vous devez substituer cette méthode pour retourner un Encoder qui conserve son état entre les appels.