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 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.