Partager via


Encoding.RegisterProvider(EncodingProvider) Méthode

Définition

Enregistre un fournisseur d'encodage.

public:
 static void RegisterProvider(System::Text::EncodingProvider ^ provider);
[System.Security.SecurityCritical]
public static void RegisterProvider (System.Text.EncodingProvider provider);
public static void RegisterProvider (System.Text.EncodingProvider provider);
[<System.Security.SecurityCritical>]
static member RegisterProvider : System.Text.EncodingProvider -> unit
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.

Attributs

Exceptions

provider a la valeur null.

Remarques

La RegisterProvider méthode vous permet d’inscrire une classe dérivée de EncodingProvider qui rend les encodages de caractères disponibles sur une plateforme qui ne les prend pas en charge autrement. Une fois que le fournisseur d’encodage est inscrit, les encodages qu’il prend en charge peuvent être récupérés en appelant une Encoding.GetEncoding surcharge. S’il existe plusieurs fournisseurs d’encodage, la Encoding.GetEncoding méthode tente de récupérer un encodage spécifié à partir de chaque fournisseur commençant par le dernier enregistré.

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) lorsqu’un argument de est passé 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.

  • Un fournisseur d’encodage personnalisé peut choisir l’encodage à retourner quand l’une de ces GetEncoding surcharges de méthode reçoit un argument de 0 . Le fournisseur peut également choisir de ne pas retourner un encodage en faisant EncodingProvider.GetEncoding retourner la méthode null .

À compter de .NET Framework 4,6, .NET Framework comprend un fournisseur d’encodage, CodePagesEncodingProvider , qui rend les encodages disponibles présents dans la .NET Framework complète, mais qui ne sont pas disponibles dans le plateforme Windows universelle. Par défaut, le plateforme Windows universelle prend en charge uniquement les encodages Unicode, ASCII et la page de codes 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. Les appels suivants sont ignorés.

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. Tous les fournisseurs précédemment inscrits sont ignorés.

S’applique à

Voir aussi