EncodingProvider Classe

Définition

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
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Héritage
EncodingProvider
Dérivé
Attributs

Remarques

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

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

À compter de la .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 ce qui remplace les deux surcharges abstraites GetEncoding et GetEncoding(Int32) GetEncoding(String). Ces surcharges retournent l’encodage non pris en charge par identificateur de page de code 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) les machines 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 disponible pour le EncodingProvider 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 de bureau .NET Framework disponible 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)

S’applique à

Voir aussi