Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

EncoderFallback, classe

Fournit un mécanisme de gestion des erreurs, appelé secours, quand un caractère en entrée ne peut pas être converti en sortie en une séquence d'octets encodée.

Espace de noms :  System.Text
Assembly :  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
public abstract class EncoderFallback

Le type EncoderFallback expose les membres suivants.

  NomDescription
Méthode protégéeEncoderFallbackInitialise une nouvelle instance de la classe EncoderFallback.
Début

  NomDescription
Propriété publiqueMembre statiqueExceptionFallbackObtient un objet qui lève une exception quand un caractère en entrée ne peut pas être encodé.
Propriété publiqueMaxCharCountEn cas de substitution dans une classe dérivée, obtient le nombre maximal de caractères que l'objet EncoderFallback en cours peut retourner.
Propriété publiqueMembre statiqueReplacementFallbackObtient un objet qui produit une chaîne de substitution à la place d'un caractère en entrée qui ne peut pas être décodé.
Début

  NomDescription
Méthode publiqueCreateFallbackBufferEn cas de substitution dans une classe dérivée, initialise une nouvelle instance de la classe EncoderFallbackBuffer.
Méthode publiqueEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début

Un encodage mappe un caractère Unicode vers une séquence codée d'octets. Un encodage particulier est représenté par un type qui est dérivé de la classe Encoding. Spécifiquement, un caractère est encodé dans une séquence d'octets en appelant la méthode Encoding.GetBytes(String) du type d'encodage, et la séquence d'octets est décodée dans un tableau ou une chaîne de caractères en appelant la méthode Encoding.GetChars(Byte[]) ou Encoding.GetString(Byte[]).

Une opération d'encodage peut échouer si le caractère en entrée ne peut pas être représenté par l'encodage. Par exemple, un objet ASCIIEncoding ne peut pas encoder un caractère dont la valeur de point de code Unicode se situe à l'extérieur de la plage comprise entre U+0000 et U+007F.

Quand la conversion de l'encodage ne peut pas être effectuée, le .NET Framework fournit un mécanisme de gestion de défaillance, appelé secours. Votre application peut utiliser l'encodeur de secours prédéfini du .NET Framework prédéfini, ou créer un encodeur de secours personnalisé dérivé des classes EncoderFallback et EncoderFallbackBuffer.

EncoderFallback et EncoderFallbackBuffer sont les classes de base de tous les gestionnaires de secours de l'encodage dans le .NET Framework. Ils prennent en charge les trois types suivants de secours qui gère des mécanismes :

  • Secours ajusté, qui mappe les caractères Unicode valides qui ne peuvent pas être encodés en un équivalent approximatif. Par exemple, un gestionnaire de secours ajusté pour la classe ASCIIEncoding peut mapper Æ (U+00C6) à AE (U+0041 + U+0045). Un gestionnaire de secours ajusté peut également être implémenté pour transcrire un alphabet (tel que cyrillique) vers un autre (tel que latin ou romain). Le .NET Framework ne fournit pas d'implémentations de secours ajustées publiques.

  • Secours de remplacement qui remplace chaque caractère qui ne peut pas être encodé par une chaîne prédéfinie. Le .NET Framework fournit un gestionnaire de secours de remplacement prédéfini. La classe EncoderReplacementFallback remplace chaque séquence d'octets qui ne peut pas être décodée avec un caractère point d'interrogation ( »? » ou U+003F) ou un CARACTÈRE DE REMPLACEMENT (U+FFFD). Vous pouvez personnaliser la chaîne de remplacement en spécifiant un substitut dans l'appel du constructeur EncoderReplacementFallback.EncoderReplacementFallback(String). Une fois la chaîne de substitution émise, l'opération d'encodage poursuit la conversion du reste de l'entrée.

  • Exception de secours qui lève une exception lorsqu'un caractère ne peut pas être encodé. Le .NET Framework fournit un gestionnaire d'exceptions de secours prédéfini. La classe EncoderExceptionFallback lève une EncoderFallbackException lorsqu'un caractère non valide est rencontré et que l'opération d'encodage termine.

Si vous choisissez d'implémenter une solution personnalisée, vous devez substituer les membres abstraits suivants de la classe EncoderFallback :

  • La méthode CreateFallbackBuffer, qui retourne une instance de classe dérivée de EncoderFallbackBuffer. Selon le type de gestionnaire de secours que vous développez, l'implémentation EncoderFallbackBuffer est chargée de l'exécution du mappage ou du remplacement, ou bien de la levée de l'exception.

  • La propriété MaxCharCount, qui retourne le nombre maximal de caractères que l'implémentation de secours peut retourner. Pour un gestionnaire d'exceptions de secours, sa valeur doit être égale à zéro.

Pour plus d'informations sur l'encodage, le décodage et les stratégies de secours, consultez Encodage de caractères dans le .NET Framework.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Date

Historique

Motif

Octobre 2010

Nombreuses modifications.

Améliorations apportées aux informations.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft