EncodingProvider EncodingProvider EncodingProvider EncodingProvider Class

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.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

public ref class EncodingProvider abstract
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Héritage
EncodingProviderEncodingProviderEncodingProviderEncodingProvider
Dérivé
Attributs

Remarques

Un fournisseur d’encodage fournit des encodages qui ne sont pas autrement disponibles sur une plateforme cible particulière.An encoding provider supplies encodings that are not otherwise available on a particular target platform.

Le .NET Framework sur le bureau Windows prend en charge un grand nombre de codages de caractères et de pages de codes.The .NET Framework on the Windows desktop supports a large number of character encodings and code pages. Vous pouvez obtenir la liste complète des encodages disponibles dans le .NET Framework sur le bureau Windows en appelant la Encoding.GetEncodings méthode.You can get a complete list of encodings available in the .NET Framework on the Windows desktop by calling the Encoding.GetEncodings method. .NET Core, en revanche, prend par défaut en charge uniquement les encodages suivants:.NET Core, on the other hand, by default supports only the following encodings:

À partir de la .NET Framework 4,6 EncodingProvider , est la classe de base qui rend les encodages autrement indisponibles disponibles pour le .NET Framework.Starting with the .NET Framework 4.6, EncodingProvider is the base class that makes otherwise unavailable encodings available to the .NET Framework. Cela implique les étapes suivantes:This involves the following steps:

  1. Définissez une sous-classe EncodingProvider de qui remplace les deux surcharges abstraites GetEncoding , GetEncoding(Int32) et GetEncoding(String).Define a subclass of EncodingProvider that overrides the two abstract GetEncoding overloads, GetEncoding(Int32) and GetEncoding(String). Ces surcharges retournent l’encodage non pris en charge par l’identificateur de page de codes et par nom.These overloads return the otherwise unsupported encoding by code page identifier and by name. Notez que vous pouvez également choisir de retourner un encodage par défaut GetEncoding(Int32) si la méthode est appelée avec un argument égal à 0.Note that you can also choose to return a default encoding if the GetEncoding(Int32) method is called with an argument of 0.

  2. Si vous le souhaitez, vous pouvez substituer GetEncoding(Int32, EncoderFallback, DecoderFallback) les GetEncoding(String, EncoderFallback, DecoderFallback) méthodes et virtuelles.Optionally, you can override the virtual GetEncoding(Int32, EncoderFallback, DecoderFallback) and GetEncoding(String, EncoderFallback, DecoderFallback) methods. Dans la plupart des cas, cela n’est pas nécessaire, car la classe de base fournit une implémentation par défaut.In most cases, this is not necessary, since the base class provides a default implementation.

  3. Transmettez EncodingProvider l’instance à Encoding.RegisterProvider la méthode pour rendre les encodages fournis par EncodingProvider l’objet disponibles pour le Common Language Runtime.Pass the EncodingProvider instance to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.

  4. Appelez une Encoding.GetEncoding surcharge pour récupérer l’encodage.Call an Encoding.GetEncoding overload to retrieve the encoding. La Encoding.GetEncoding méthode appellera le correspondant EncodingProvider.GetEncoding pour déterminer s’il peut fournir l’encodage demandé.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding to determine whether it can supply the requested encoding.

La bibliothèque de classes .NET Framework fournit une propriété statique CodePagesEncodingProvider.Instance,, qui retourne EncodingProvider un objet qui rend le jeu complet de codages disponible sur la bibliothèque de classes de .NET Framework de .NET Core.NET Core Bureau à la disposition des applications.The .NET Framework Class Library provides one static property, CodePagesEncodingProvider.Instance, that returns an EncodingProvider object that makes the full set of encodings available on the desktop .NET Framework Class Library available to .NET Core.NET Core applications. En outre, vous pouvez dériver de EncodingProvider la classe pour rendre vos propres encodages disponibles.In addition, you can derive from the EncodingProvider class to make your own encodings available.

Constructeurs

EncodingProvider() EncodingProvider() EncodingProvider() EncodingProvider()

Initialise une nouvelle instance de la classe EncodingProvider.Initializes a new instance of the EncodingProvider class.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Retourne l'encodage associé à l'identificateur de page de codes spécifié.Returns the encoding associated with the specified code page identifier.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Retourne l'encodage associé à l'identificateur de page de codes spécifié.Returns the encoding associated with the specified code page identifier. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Retourne l’encodage avec le nom spécifié.Returns the encoding with the specified name.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Retourne l’encodage associé au nom spécifié.Returns the encoding associated with the specified name. 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.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à

Voir aussi