Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Encoding.RegisterProvider(EncodingProvider) Method

Définition

Enregistre un fournisseur d'encodage.Registers an encoding provider.

public:
 static void RegisterProvider(System::Text::EncodingProvider ^ provider);
[System.Security.SecurityCritical]
public static void RegisterProvider (System.Text.EncodingProvider provider);
static member RegisterProvider : System.Text.EncodingProvider -> unit
Public Shared Sub RegisterProvider (provider As EncodingProvider)

Paramètres

provider
EncodingProvider EncodingProvider EncodingProvider EncodingProvider

Sous-classe de EncodingProvider qui fournit l'accès à des encodages de caractères supplémentaires.A subclass of EncodingProvider that provides access to additional character encodings.

Exceptions

Remarques

Le RegisterProvider méthode vous permet d’enregistrer une classe dérivée de EncodingProvider qui rend caractères encodages disponibles sur une plateforme qui ne les gère pas dans le cas contraire.The RegisterProvider method allows you to register a class derived from EncodingProvider that makes character encodings available on a platform that does not otherwise support them. Une fois que le fournisseur d’encodage est inscrit, les encodages pris en charge peuvent être récupérées en appelant une Encoding.GetEncoding de surcharge.Once the encoding provider is registered, the encodings that it supports can be retrieved by calling any Encoding.GetEncoding overload. S’il existe plusieurs fournisseurs d’encodage, le Encoding.GetEncoding méthode tente de récupérer un encodage spécifié à partir de chaque fournisseur en commençant par la plus récemment enregistré.If there are multiple encoding providers, the Encoding.GetEncoding method attempts to retrieve a specified encoding from each provider starting with the one most recently registered.

L’inscription d’un fournisseur d’encodage à l’aide de la RegisterProvider méthode modifie également le comportement de la Encoding.GetEncoding (Int32) et EncodingProvider.GetEncoding (Int32, EncoderFallback, DecoderFallback ) méthodes quand il est passé un argument de 0:Registering an encoding provider by using the RegisterProvider method also modifies the behavior of the Encoding.GetEncoding(Int32) and EncodingProvider.GetEncoding(Int32, EncoderFallback, DecoderFallback) methods when passed an argument of 0:

  • Si le fournisseur inscrit est le CodePagesEncodingProvider, la méthode retourne l’encodage qui correspond à la page de code active du système lors de l’exécution sur le système d’exploitation Windows.If the registered provider is the CodePagesEncodingProvider, the method returns the encoding that matches the system active code page when running on the Windows operating system.

  • Un fournisseur d’encodage personnalisé peut choisir le codage à retourner lorsque une de ces GetEncoding surcharges de méthode est passé un argument de 0.A custom encoding provider can choose which encoding to return when either of these GetEncoding method overloads is passed an argument of 0. Le fournisseur peut également choisir de ne renvoyer un encodage en ayant la EncodingProvider.GetEncoding retour de la méthode null.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

À compter de .NET Framework 4.6, le .NET Framework inclut un fournisseur d’encodage, CodePagesEncodingProvider, qui rend les encodages disponibles qui sont présents dans le .NET Framework complet, mais ne sont pas disponibles dans la plateforme Windows universelle.Starting with the .NET Framework 4.6, the .NET Framework includes one encoding provider, CodePagesEncodingProvider, that makes the encodings available that are present in the full .NET Framework but are not available in the Universal Windows Platform. Par défaut, la plateforme Windows universelle ne prend en charge les encodages Unicode, ASCII et la page de codes 28591.By default, the Universal Windows Platform only supports the Unicode encodings, ASCII, and code page 28591.

Si le même fournisseur d’encodage est utilisé dans plusieurs appels à la RegisterProvider méthode, seul le premier appel de méthode inscrit le fournisseur.If the same encoding provider is used in multiple calls to the RegisterProvider method, only the first method call registers the provider. Les appels suivants sont ignorés.Subsequent calls are ignored.

Si le RegisterProvider méthode est appelée pour inscrire plusieurs fournisseurs qui gèrent le même encodage, le dernier fournisseur inscrit est utilisée pour tous les de codage et d’opérations de décodage.If the RegisterProvider method is called to register multiple providers that handle the same encoding, the last registered provider is the used for all encoding and decoding operations. Les fournisseurs inscrits précédemment sont ignorés.Any previously registered providers are ignored.

S’applique à

Voir aussi