CodePagesEncodingProvider Classe

Définition

public ref class CodePagesEncodingProvider sealed

public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider

[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider

public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider

[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class

type CodePagesEncodingProvider = class
    inherit EncodingProvider

Public NotInheritable Class CodePagesEncodingProvider

Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider

Héritage

Object

CodePagesEncodingProvider

Héritage

Object

EncodingProvider

CodePagesEncodingProvider

Attributs

SecurityCriticalAttribute

Remarques

Le .NET Framework pour le bureau Windows prend en charge un grand ensemble d’encodages unicode et de pages de codes. .NET Core prend en charge uniquement les encodages suivants :

• ASCII (page de codes 20127), qui est retournée par la Encoding.ASCII propriété.

• ISO-8859-1 (page de codes 28591).

• UTF-7 (page de codes 65000), qui est retournée par la Encoding.UTF7 propriété.

• UTF-8 (page de codes 65001), qui est retournée par la Encoding.UTF8 propriété.

• UTF-16 et UTF-16LE (page de codes 1200), qui est retournée par la Encoding.Unicode propriété.

• UTF-16BE (page de codes 1201), qui est instanciée en appelant le ou UnicodeEncoding.UnicodeEncoding le UnicodeEncoding.UnicodeEncoding constructeur avec une bigEndian valeur de true.

• UTF-32 et UTF-32LE (page de codes 12000), qui est retournée par la Encoding.UTF32 propriété.

• UTF-32BE (page de codes 12001), qui est instanciée en appelant un UTF32Encoding constructeur qui a un bigEndian paramètre et fournissant une valeur dans l’appel de true méthode.

Autres que la page de codes 20127, les encodages de page de codes ne sont pas pris en charge.

La CodePagesEncodingProvider classe s’étend EncodingProvider pour rendre ces pages de code disponibles pour .NET Core. Pour utiliser ces pages de codes supplémentaires, procédez comme suit :

• Récupérez un CodePagesEncodingProvider objet à partir de la propriété statique CodePagesEncodingProvider.Instance .

• Passez l’objet CodePagesEncodingProvider à la Encoding.RegisterProvider méthode.

Une fois qu’un EncodingProvider objet est inscrit, les encodages qu’il prend en charge sont disponibles en appelant les surcharges Encoding.GetEncoding; vous ne devez pas appeler les EncodingProvider.GetEncoding surcharges.

Impact sur le comportement d’encodage par défaut

L’inscription CodePagesEncodingProvider affecte également le comportement de GetEncoding(Int32) lorsqu’il est appelé avec un codepage argument de 0 .NET (Core) :

• Sur Windows, GetEncoding(0) retourne l’encodage qui correspond à la page de codes active du système, qui est le même comportement que dans .NET Framework.
• Sur les plateformes non-Windows, GetEncoding(0) retourne UTF-8, en conservant la cohérence entre plateformes.

Lorsqu’aucun fournisseur d’encodage n’est inscrit, GetEncoding(0) retourne UTF-8 sur toutes les plateformes dans .NET Core et versions ultérieures.