Encoding.RegisterProvider(EncodingProvider) Méthode

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

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.

Attributs

Exceptions

provider est null.provider is null.

Remarques

La RegisterProvider méthode vous permet d’inscrire une classe dérivée EncodingProvider de qui rend les encodages de caractères disponibles sur une plateforme qui ne les prend pas en charge autrement.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 qu’il prend en charge Encoding.GetEncoding peuvent être récupérés en appelant une 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 Encoding.GetEncoding , la méthode tente de récupérer un encodage spécifié à partir de chaque fournisseur commençant par le dernier 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 des méthodes Encoding. GetEncoding (Int32) et EncodingProvider. GetEncoding (Int32, EncoderFallback, DecoderFallback) en cas de réussite d’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 codes 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 l’encodage à retourner quand GetEncoding l’une de ces surcharges de méthode 0reçoit un argument de.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 pas retourner un encodage en EncodingProvider.GetEncoding faisant retourner nullla méthode.The provider can also choose to not return an encoding by having the EncodingProvider.GetEncoding method return null.

À partir de la .NET Framework 4,6, le .NET Framework comprend un fournisseur d' CodePagesEncodingProviderencodage,, qui rend les encodages disponibles présents dans la .NET Framework complète, mais qui ne sont pas disponibles dans le 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, le plateforme Windows universelle prend en charge uniquement 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 RegisterProvider à la 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 la RegisterProvider méthode est appelée pour inscrire plusieurs fournisseurs qui gèrent le même encodage, le dernier fournisseur inscrit est utilisé pour toutes les opérations d’encodage et 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. Tous les fournisseurs précédemment inscrits sont ignorés.Any previously registered providers are ignored.

S’applique à

Voir aussi