EncodingProvider Classe

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

EncodingProvider.cs

Fournit la classe de base d’un fournisseur d’encodage, qui fournit des encodages non disponibles sur une plateforme particulière.

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Héritage

Object

EncodingProvider

Dérivé

System.Text.CodePagesEncodingProvider

Remarques

Un fournisseur d’encodage fournit des encodages qui ne sont pas disponibles dans une plateforme cible particulière.

.NET Framework prend en charge un grand nombre d’encodages de caractères et de pages de code. Vous pouvez obtenir la liste complète des encodages disponibles dans le .NET Framework en appelant la Encoding.GetEncodings méthode. .NET Core, par défaut, prend uniquement en charge les encodages suivants :

• ASCII (page de codes 20127), qui est retournée par la Encoding.ASCII propriété.

• ISO-8859-1 (page de codes 28591).

• UTF-7 (page de codes 65000), qui est retournée par la Encoding.UTF7 propriété.

• UTF-8 (page de codes 65001), qui est retournée par la Encoding.UTF8 propriété.

• UTF-16 et UTF-16LE (page de codes 1200), qui est retournée par la Unicode propriété.

• UTF-16BE (page de codes 1201), qui est instanciée en appelant le ou UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) le UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) constructeur avec une bigEndian valeur de true.

• UTF-32 et UTF-32LE (page de codes 12000), qui est retournée par la Encoding.UTF32 propriété.

• UTF-32BE (page de codes 12001), qui est instanciée en appelant un UTF32Encoding constructeur qui a un bigEndian paramètre et fournissant une valeur dans l’appel de true méthode.

À compter du .NET Framework 4.6, EncodingProvider est la classe de base qui rend les encodages non disponibles dans le .NET Framework. Cela implique les étapes suivantes :

1. Définissez une sous-classe de EncodingProvider qui remplace les deux surcharges abstraites GetEncoding , GetEncoding(Int32) et GetEncoding(String). Ces surcharges retournent l’encodage non pris en charge autrement par identificateur de page de codes et par nom. Notez que vous pouvez également choisir de retourner un encodage par défaut si la GetEncoding(Int32) méthode est appelée avec un argument de 0.

2. Si vous le souhaitez, vous pouvez remplacer les méthodes et GetEncoding(String, EncoderFallback, DecoderFallback) virtuellesGetEncoding(Int32, EncoderFallback, DecoderFallback). Dans la plupart des cas, cela n’est pas nécessaire, car la classe de base fournit une implémentation par défaut.

3. Transmettez l’instance EncodingProvider à la Encoding.RegisterProvider méthode pour rendre les encodages fournis par l’objet EncodingProvider à la disposition du Common Language Runtime.

4. Appelez une Encoding.GetEncoding surcharge pour récupérer l’encodage. La Encoding.GetEncoding méthode appelle le correspondant EncodingProvider.GetEncoding pour déterminer s’il peut fournir l’encodage demandé.

La bibliothèque de classes .NET Framework fournit une propriété statique, CodePagesEncodingProvider.Instancequi retourne un EncodingProvider objet qui rend l’ensemble complet d’encodages disponibles sur la bibliothèque de classes .NET Framework de bureau disponible pour les applications .NET Core. En outre, vous pouvez dériver de la EncodingProvider classe pour rendre vos propres encodages disponibles.

Constructeurs

Nom	Description
EncodingProvider()	Initialise une nouvelle instance de la classe EncodingProvider.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retourne l’encodage associé à l’identificateur de page de codes spécifié. Les paramètres spécifient un gestionnaire d’erreurs pour les caractères qui ne peuvent pas être encodés et des séquences d’octets qui ne peuvent pas être décodées.
GetEncoding(Int32)	Retourne l’encodage associé à l’identificateur de page de codes spécifié.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retourne l’encodage associé au nom spécifié. Les paramètres spécifient un gestionnaire d’erreurs pour les caractères qui ne peuvent pas être encodés et des séquences d’octets qui ne peuvent pas être décodées.
GetEncoding(String)	Retourne l’encodage avec le nom spécifié.
GetEncodings()	Retourne un tableau qui contient tous les encodages pris en charge par le EncodingProvider.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• GetEncoding(String)
• Instance