Encoding.RegisterProvider(EncodingProvider) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitstatic member RegisterProvider : System.Text.EncodingProvider -> unitPublic 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éthodenull.
À 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.