EncodingProvider Classe

Définition

Espace de noms:

System.Text

Assembly:

System.Runtime.dll

Source:

EncodingProvider.cs

Fournit la classe de base pour un fournisseur d'encodage, qui fournit des encodages qui ne sont pas disponibles sur une plateforme donnée.

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 autrement disponibles sur une plateforme cible particulière.

Le .NET Framework prend en charge un grand nombre d’encodages de caractères et de pages de codes. Vous pouvez obtenir une 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é par la Encoding.ASCII propriété .

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

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

• UTF-8 (page de codes 65001), qui est retourné 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é en appelant le UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) constructeur ou UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) avec la bigEndian valeur 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é en appelant un UTF32Encoding constructeur qui a un bigEndian paramètre et en fournissant une valeur de dans l’appel de true méthode.

À compter de .NET Framework 4.6, EncodingProvider est la classe de base qui rend les encodages autrement indisponibles disponibles pour 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 autrement non pris en charge 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 virtuelles GetEncoding(Int32, EncoderFallback, DecoderFallback) et GetEncoding(String, 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. Passez le EncodingProvider instance à la Encoding.RegisterProvider méthode pour rendre les encodages fournis par l’objet EncodingProvider disponibles pour le 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.Instance, qui retourne un EncodingProvider objet qui rend l’ensemble complet des encodages disponibles sur la bibliothèque de classes .NET Framework de bureau pour les applications .NET Core. En outre, vous pouvez dériver de la EncodingProvider classe pour rendre vos propres encodages disponibles.

Constructeurs

EncodingProvider()

Initialise une nouvelle instance de la classe EncodingProvider.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEncoding(Int32)	Retourne l'encodage associé à l'identificateur de page de codes spécifié.
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 pour les séquences d'octets qui ne peuvent pas être décodées.
GetEncoding(String)	Retourne l’encodage avec le nom 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 pour les séquences d'octets qui ne peuvent pas être décodées.
GetEncodings()	Retourne un tableau qui contient tous les encodages pris en charge par EncodingProvider.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• GetEncoding(String)
• Instance