CodePagesEncodingProvider.GetEncoding Méthode

Définition

Espace de noms:

System.Text

Assembly:

System.Text.Encoding.CodePages.dll

Surcharges

Nom	Description
GetEncoding(Int32)	Retourne l’encodage associé à l’identificateur de page de codes spécifié.
GetEncoding(String)	Retourne l’encodage associé au nom de la page de codes spécifiée.

Remarques

.NET Framework prend en charge un grand nombre d’encodages de caractères et de pages de code. Vous pouvez obtenir une liste complète des encodages en appelant la Encoding.GetEncodings méthode, qui est disponible dans le .NET Framework. En revanche, .NET Core prend uniquement en charge les encodages suivants par défaut :

• 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.

Pour récupérer un encodage présent dans .NET Framework, mais pas dans .NET Core, procédez comme suit :

• Ajoutez une référence à l’assembly System.Text.Encoding.CodePages.dll à votre projet.

• Obtenez l’objet EncodingProvider à partir de la propriété statique CodePagesEncodingProvider.Instance .

• Transmettez l’objet EncodingProvider à la Encoding.RegisterProvider méthode pour rendre les encodages fournis par l’objet disponibles pour le EncodingProvider Common Language Runtime.

• Appelez une Encoding.GetEncoding surcharge pour récupérer l’encodage. La Encoding.GetEncoding méthode appelle la méthode correspondante EncodingProvider.GetEncoding pour déterminer s’il peut fournir l’encodage demandé.

GetEncoding(Int32)

Source:

CodePagesEncodingProvider.cs

Retourne l’encodage associé à l’identificateur de page de codes spécifié.

public:
 override System::Text::Encoding ^ GetEncoding(int codepage);

public override System.Text.Encoding? GetEncoding(int codepage);

override this.GetEncoding : int -> System.Text.Encoding

Public Overrides Function GetEncoding (codepage As Integer) As Encoding

Paramètres

codepage

Int32

Identificateur de la page de codes de l’encodage préféré pris en charge par le fournisseur d’encodage.

Retours

Encoding

Encodage associé à l’identificateur de page de codes spécifié ou null si le fournisseur ne prend pas en charge l’encodage de la page de codes demandé.

Remarques

Cette méthode permet d’accéder aux encodages de page de codes disponibles dans .NET Framework, mais qui ne sont pas pris en charge en mode natif dans .NET Core et les versions ultérieures.

Quand codepage c’est 0le cas, cette méthode a un comportement spécial qui affecte l’encodage par défaut retourné par GetEncoding(Int32):

• Sur Windows : retourne l’encodage qui correspond à la page de codes active du système, en fournissant le même comportement que .NET Framework.
• Sur les plateformes non-Windows : retourne null, ce qui permet GetEncoding(Int32) de revenir à son comportement UTF-8 par défaut.

Pour tous les autres identificateurs de page de codes pris en charge, cette méthode retourne l’encodage correspondant s’il est disponible auprès du fournisseur d’encodage de pages de codes ou null si la page de codes n’est pas prise en charge.

GetEncoding(String)

Source:

CodePagesEncodingProvider.cs

Retourne l’encodage associé au nom de la page de codes spécifiée.

public:
 override System::Text::Encoding ^ GetEncoding(System::String ^ name);

public override System.Text.Encoding? GetEncoding(string name);

override this.GetEncoding : string -> System.Text.Encoding

Public Overrides Function GetEncoding (name As String) As Encoding

Paramètres

name

String

Nom de la page de codes de l’encodage préféré pris en charge par le fournisseur d’encodage.

Retours

Encoding

Encodage associé à la page de codes spécifiée ou null si le fournisseur ne prend pas en charge l’encodage demandé.