EncodingProvider.GetEncoding Méthode

Définition

Espace de noms:

System.Text

Assembly:

System.Runtime.dll

Retourne un encodage.

Surcharges

GetEncoding(Int32)	Retourne l'encodage associé à l'identificateur de page de codes spécifié.
GetEncoding(String)	Retourne l’encodage avec le nom spécifié.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retourne l'encodage associé à l'identificateur de page de codes spécifié. Les paramètres spécifient un gestionnaire d'erreurs pour les caractères qui ne peuvent pas être encodés et pour les séquences d'octets qui ne peuvent pas être décodées.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retourne l’encodage associé au nom spécifié. Les paramètres spécifient un gestionnaire d'erreurs pour les caractères qui ne peuvent pas être encodés et pour les séquences d'octets qui ne peuvent pas être décodées.

GetEncoding(Int32)

Source:

EncodingProvider.cs

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

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

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

abstract member GetEncoding : int -> System.Text.Encoding

Public MustOverride Function GetEncoding (codepage As Integer) As Encoding

Paramètres

codepage

Int32

Identificateur de page de code de l’encodage demandé.

Retours

Encoding

Encodage associé à la page de code spécifiée ou null si ce EncodingProvider ne peut pas retourner d'encodage valide qui correspond à codepage.

Remarques

Notes aux appelants

Cette méthode est appelée par la méthode Encoding.GetEncoding(Int32). Vous ne devez pas l’appeler directement à partir du code utilisateur.

Notes pour les responsables de l’implémentation

Vous remplacez la GetEncoding(Int32) méthode pour retourner l’encodage ou les encodages pris en charge par votre EncodingProvider sous-classe. Lorsque le code utilisateur tente de récupérer un encodage en appelant la méthode, la GetEncoding(Int32) méthode transmet l’identificateur codepage à chaque fournisseur d’encodage inscrit jusqu’à ce que l’un d’eux retourne un encodage valide. Si aucun ne retourne un encodage valide, la GetEncoding(Int32) méthode tente de récupérer un encodage mis en cache dont l’identificateur de page de code est codepage. Pour cette raison, si codepage n’est pas l’identificateur de page de code d’un encodage que vous prenez en charge, la méthode doit retourner null; elle ne doit jamais lever d’exception.

Notes pour les appelants

Cette méthode est appelée par la GetEncoding(Int32) méthode . Vous ne devez pas l’appeler directement à partir du code utilisateur.

Voir aussi

• GetEncoding(Int32)

GetEncoding(String)

Source:

EncodingProvider.cs

Retourne l’encodage avec le nom spécifié.

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

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

abstract member GetEncoding : string -> System.Text.Encoding

Public MustOverride Function GetEncoding (name As String) As Encoding

Paramètres

name

String

Nom de l’encodage demandé.

Retours

Encoding

Encodage associé au nom spécifié, ou null si ce EncodingProvider ne peut pas retourner d’encodage valide qui correspond à name.

Remarques

Remarques à l’attention des héritiers

Vous remplacez la méthode GetEncoding(String) pour renvoyer l’encodage ou les encodages pris en charge par votre EncodingProvider sous-classe. Lorsque le code utilisateur tente de récupérer un encodage en appelant la méthode GetEncoding(String), la méthode transmet l’argument name à chaque fournisseur d’encodage inscrit jusqu’à ce que l’un d’eux retourne un encodage valide. Si aucun ne retourne un encodage valide, la méthode GetEncoding(String) tente de récupérer un encodage mis en cache dont le nom est name. Pour cette raison, si name n’est pas le nom d’un encodage que vous prenez en charge, la méthode doit retourner null. Le seul cas dans lequel la méthode doit lever une exception est si name est null.

Notes aux appelants

Cette méthode est appelée par la méthode Encoding.GetEncoding(String). Vous ne devez pas l’appeler directement à partir du code utilisateur.

Notes pour les responsables de l’implémentation

Vous remplacez la GetEncoding(String) méthode pour retourner l’encodage ou les encodages pris en charge par votre EncodingProvider sous-classe. Lorsque le code utilisateur tente de récupérer un encodage en appelant la méthode, la GetEncoding(String) méthode transmet l’argument name à chaque fournisseur d’encodage inscrit jusqu’à ce que l’un d’eux retourne un encodage valide. Si aucun ne retourne un encodage valide, la GetEncoding(String) méthode tente de récupérer un encodage mis en cache dont le nom est name. Pour cette raison, si name n’est pas le nom d’un encodage que vous prenez en charge, la méthode doit retourner null. Le seul cas dans lequel la méthode doit lever une exception est si name est null.

Notes pour les appelants

Cette méthode est appelée par la GetEncoding(String) méthode . Vous ne devez pas l’appeler directement à partir du code utilisateur.

Voir aussi

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Source:

EncodingProvider.cs

Retourne l'encodage associé à l'identificateur de page de codes spécifié. Les paramètres spécifient un gestionnaire d'erreurs pour les caractères qui ne peuvent pas être encodés et pour les séquences d'octets qui ne peuvent pas être décodées.

public:
 virtual System::Text::Encoding ^ GetEncoding(int codepage, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (int codepage, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : int * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (codepage As Integer, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Paramètres

codepage

Int32

Identificateur de page de code de l’encodage demandé.

encoderFallback

EncoderFallback

Objet qui fournit une procédure de gestion des erreurs quand un caractère ne peut pas être encodé avec cet encodage.

decoderFallback

DecoderFallback

Objet qui fournit une procédure de gestion des erreurs quand une séquence d’octets ne peut pas être décodée avec cet encodage.

Retours

Encoding

Encodage associé à la page de code spécifiée ou null si ce EncodingProvider ne peut pas retourner d'encodage valide qui correspond à codepage.

Remarques

Les encoderFallback paramètres et decoderFallback sont des objets qui définissent la stratégie de secours utilisée dans le cas où un encodeur ne peut pas convertir un caractère en une séquence d’octets ou qu’un décodeur ne peut pas convertir une séquence d’octets en caractère. Le .NET Framework fournit les mécanismes de secours suivants :

• Exception de secours. Si l’argument encoderFallback est un instance de EncoderExceptionFallback, ou si l’argument decoderExceptionFallback est un instance de , la méthode d’encodage DecoderExceptionFallbacklève une exception si les caractères ne peuvent pas être encodés et si la méthode de décodage lève une exception si une séquence d’octets ne peut pas être décodée.

• Remplacement de secours. Si l’argument encoderFallback est une instance de EncoderReplacementFallback, ou si l’argument decoderExceptionFallback est un instance de , les méthodes d’encodage et de DecoderReplacementFallbackdécodage remplacent une chaîne de remplacement pour les caractères qui ne peuvent pas être encodés et les séquences d’octets ne peuvent pas être décodées. Si vous avez instancié l’objet de secours de remplacement en appelant le constructeur sans paramètre, le caractère de remplacement est un « ? ». Si vous appelez le EncoderReplacementFallback.EncoderReplacementFallback(String) constructeur ou DecoderReplacementFallback.DecoderReplacementFallback(String) , vous pouvez spécifier la chaîne de remplacement.

• Meilleure solution de secours. Vous pouvez dériver de la EncoderFallback classe ou DecoderFallback pour implémenter un mécanisme de remplacement le mieux adapté.

Notes pour les héritiers

Étant donné que les appels à cette méthode utilisent votre implémentation de la GetEncoding(Int32) méthode, vous n’avez pas besoin de la remplacer. Lorsque le code utilisateur tente de récupérer un encodage en appelant la méthode, la GetEncoding(Int32, EncoderFallback, DecoderFallback) méthode transmet l’identificateur codepage à chaque fournisseur d’encodage inscrit jusqu’à ce que l’un d’eux retourne un encodage valide. Si aucun ne retourne un encodage valide, la GetEncoding(Int32) méthode tente de récupérer un encodage mis en cache dont l’identificateur de page de code est codepage. Pour cette raison, si vous choisissez de remplacer la méthode, votre GetEncoding(Int32, EncoderFallback, DecoderFallback) remplacement doit retourner null si codepage n’est pas l’identificateur de page de code d’un encodage que vous prenez en charge ; il ne doit jamais lever d’exception.

Notes pour les appelants

Cette méthode est appelée par la GetEncoding(Int32, EncoderFallback, DecoderFallback) méthode . Vous ne devez pas l’appeler directement à partir du code utilisateur.

Voir aussi

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Source:

EncodingProvider.cs

Retourne l’encodage associé au nom spécifié. Les paramètres spécifient un gestionnaire d'erreurs pour les caractères qui ne peuvent pas être encodés et pour les séquences d'octets qui ne peuvent pas être décodées.

public:
 virtual System::Text::Encoding ^ GetEncoding(System::String ^ name, System::Text::EncoderFallback ^ encoderFallback, System::Text::DecoderFallback ^ decoderFallback);

public virtual System.Text.Encoding? GetEncoding (string name, System.Text.EncoderFallback encoderFallback, System.Text.DecoderFallback decoderFallback);

abstract member GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding
override this.GetEncoding : string * System.Text.EncoderFallback * System.Text.DecoderFallback -> System.Text.Encoding

Public Overridable Function GetEncoding (name As String, encoderFallback As EncoderFallback, decoderFallback As DecoderFallback) As Encoding

Paramètres

name

String

Nom de l’encodage préféré.

encoderFallback

EncoderFallback

Objet qui fournit une procédure de gestion des erreurs quand un caractère ne peut pas être encodé avec cet encodage.

decoderFallback

DecoderFallback

Objet qui fournit une procédure de gestion d'erreurs quand une séquence d'octets ne peut pas être décodée avec l'encodage actuel.

Retours

Encoding

Encodage associé au nom spécifié, ou null si ce EncodingProvider ne peut pas retourner d’encodage valide qui correspond à name.

Remarques

Les encoderFallback paramètres et decoderFallback sont des objets qui définissent la stratégie de secours utilisée dans le cas où un encodeur ne peut pas convertir un caractère en une séquence d’octets ou qu’un décodeur ne peut pas convertir une séquence d’octets en caractère. Le .NET Framework fournit les mécanismes de secours suivants :

• Exception de secours. Si l’argument encoderFallback est un instance de EncoderExceptionFallback, ou si l’argument decoderExceptionFallback est un instance de , la méthode d’encodage DecoderExceptionFallbacklève une exception si les caractères ne peuvent pas être encodés et si la méthode de décodage lève une exception si une séquence d’octets ne peut pas être décodée.

• Remplacement de secours. Si l’argument encoderFallback est une instance de EncoderReplacementFallback, ou si l’argument decoderExceptionFallback est un instance de , les méthodes d’encodage et de DecoderReplacementFallbackdécodage remplacent une chaîne de remplacement pour les caractères qui ne peuvent pas être encodés et les séquences d’octets ne peuvent pas être décodées. Si vous avez instancié l’objet de secours de remplacement en appelant le constructeur sans paramètre, le caractère de remplacement est un « ? ». Si vous appelez le EncoderReplacementFallback.EncoderReplacementFallback(String) constructeur ou DecoderReplacementFallback.DecoderReplacementFallback(String) , vous pouvez spécifier la chaîne de remplacement.

• Meilleure solution de secours. Vous pouvez dériver de la EncoderFallback classe ou DecoderFallback pour implémenter un mécanisme de remplacement le mieux adapté.

Notes pour les héritiers

Étant donné que les appels à cette méthode utilisent votre implémentation de la GetEncoding(String) méthode, vous n’avez pas besoin de la remplacer. Lorsque le code utilisateur tente de récupérer un encodage en appelant la méthode, la GetEncoding(String, EncoderFallback, DecoderFallback) méthode transmet l’identificateur codepage à chaque fournisseur d’encodage inscrit jusqu’à ce que l’un d’eux retourne un encodage valide. Si aucun ne retourne un encodage valide, la GetEncoding(Int32) méthode tente de récupérer un encodage mis en cache dont l’identificateur de page de code est codepage. Pour cette raison, si vous choisissez de remplacer la méthode, votre GetEncoding(Int32, EncoderFallback, DecoderFallback) remplacement doit retourner null si codepage n’est pas l’identificateur de page de code d’un encodage que vous prenez en charge ; il ne doit jamais lever d’exception.

Notes pour les appelants

Cette méthode est appelée par la GetEncoding(String, EncoderFallback, DecoderFallback) méthode . Vous ne devez pas l’appeler directement à partir du code utilisateur.

Voir aussi

• GetEncoding(String, EncoderFallback, DecoderFallback)