EncoderFallbackBuffer Classe

Définition

public ref class EncoderFallbackBuffer abstract

public abstract class EncoderFallbackBuffer

type EncoderFallbackBuffer = class

Public MustInherit Class EncoderFallbackBuffer

Héritage

Object

EncoderFallbackBuffer

Dérivé

System.Text.EncoderExceptionFallbackBuffer

System.Text.EncoderReplacementFallbackBuffer

Remarques

Un encodage définit un mappage entre un caractère Unicode et une séquence codée d’octets. Une opération d’encodage, qui convertit un caractère d’entrée en séquence d’octets de sortie, échoue si aucun mappage n’est défini pour un caractère particulier.

Le .NET Framework fournit un mécanisme de gestion des défaillances, appelé secours, si une conversion ne peut pas être effectuée. Tous les gestionnaires de secours de l’encodeur doivent implémenter les éléments suivants :

• Secours de l’encodeur, qui est représenté par une classe dérivée de la EncoderFallback classe.

• Mémoire tampon de secours de l’encodeur, représentée par un type dérivé de la EncoderFallbackBuffer classe qui peut retourner une chaîne à l’opération de conversion.

Les secours peuvent utiliser trois stratégies pour gérer les échecs de conversion :

• Mappage le mieux adapté. La mémoire tampon de secours de l’encodeur peut retourner une chaîne qui représente une approximation proche du caractère d’entrée. Le .NET Framework ne fournit pas d’implémentation adaptée au public EncoderFallbackBuffer .

• Remplacement. La mémoire tampon de secours de l’encodeur peut retourner une chaîne, telle qu’un point d’interrogation (« ? »), qui indique qu’un caractère n’a pas pu être encodé. Dans .NET Framework, les EncoderReplacementFallback classes et EncoderReplacementFallbackBuffer les classes fournissent une implémentation de mémoire tampon de secours de remplacement publique. Le constructeur de la EncoderReplacementFallback classe vous permet de définir la chaîne de remplacement.

• Exception. L’implémentation EncoderFallbackBuffer lève une exception, qui indique qu’un caractère ne peut pas être encodé et met fin à l’opération d’encodage. Dans ce cas, le gestionnaire de secours doit fournir une EncoderFallbackBuffer implémentation, bien qu’il ne retourne pas de chaîne à l’encodeur. Dans le .NET Framework, les EncoderExceptionFallback classes fournissent EncoderExceptionFallbackBuffer une implémentation de secours d’exception publique qui lève une EncoderFallbackException exception lorsqu’un caractère ne peut pas être encodé.

La mémoire tampon d’une EncoderFallbackBuffer implémentation représente la chaîne entière à retourner à l’encodeur en réponse à un secours d’encodeur. En règle générale, les implémentations incluent également des informations d’état, telles que l’index du caractère suivant pour revenir à l’encodeur et le nombre de caractères restants à retourner. Étant donné qu’il EncoderFallbackBuffer s’agit d’une classe abstraite, il nécessite des classes dérivées pour implémenter au minimum les membres suivants :

• Méthode surchargée Fallback , appelée par l’encodeur lorsqu’elle ne peut pas encoder un caractère. L’encodeur transmet deux informations à l’implémentation de la mémoire tampon de secours : le caractère ou la paire de substitution qui n’a pas pu être encodée et l’index du caractère dans l’entrée. Dans un gestionnaire d’exceptions de secours d’encodeur, l’exception est levée dans cette méthode. Sinon, la méthode retourne true si elle fournit une secours ou false si elle ne le fait pas.

• La GetNextChar méthode, appelée à plusieurs reprises par l’encodeur si la Fallback méthode retourne true. Dans les appels successifs, le gestionnaire doit retourner chaque caractère dans sa mémoire tampon. Lorsqu’il a retourné tous les caractères, il doit retourner U+0000. Un gestionnaire d’exceptions retourne toujours U+0000.

• Méthode MovePrevious , qui tente de déplacer le pointeur vers la position précédente dans la mémoire tampon et indique si le déplacement a réussi. Un gestionnaire d’exceptions retourne falsetoujours .

• Propriété Remaining , qui indique le nombre de caractères restants à retourner à l’encodeur. Un gestionnaire de secours d’exception retourne toujours zéro.

Voir aussi

• EncoderFallback
• Encodage de caractères dans le .NET Framework