EncodingProvider.GetEncoding Méthode

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

Retours

Encodage associé à la page de codes spécifiée, ou null s’il EncodingProvider ne peut pas retourner un encodage valide correspondant à codepage.

Remarques

Remarques pour les 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 GetEncoding(Int32) méthode, la méthode transmet l’identificateur codepage à chaque fournisseur d’encodage inscrit jusqu’à ce que l’on retourne un encodage valide. Si aucun ne retourne un encodage valide, la méthode tente de récupérer un encodage mis en cache dont l’identificateur GetEncoding(Int32) de page de codes est codepage. En raison de cela, si codepage ce n’est pas l’identificateur de page de codes 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)

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

Retours

Encodage associé au nom spécifié, ou null s’il EncodingProvider ne peut pas retourner un encodage valide correspondant à name.

Remarques

Remarques pour les 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 qu’un encodage soit retourné. Si aucun retourne un encodage valide, la méthode GetEncoding(String) tente de récupérer un encodage mis en cache dont le nom est name. En raison de cela, si name ce 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 le cas namenulléchéant .

Remarques pour les 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 GetEncoding(String) méthode, la méthode transmet l’argument name à chaque fournisseur d’encodage inscrit jusqu’à ce que l’on retourne un encodage valide. Si aucun ne retourne un encodage valide, la méthode tente de récupérer un encodage mis en cache dont le GetEncoding(String) nom est name. En raison de cela, si name ce 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 le cas namenulléchéant .

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)

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

Retours

Encodage associé à la page de codes spécifiée, ou null s’il EncodingProvider ne peut pas retourner un encodage valide correspondant à codepage.

Remarques

Les encoderFallback paramètres et decoderFallback les objets 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 un décodeur ne peut pas convertir une séquence d’octets en un caractère. .NET Framework fournit les mécanismes de secours suivants :

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

• Secours de remplacement. Si l’argument encoderFallback est une instance de EncoderReplacementFallback, ou si l’argument decoderExceptionFallback est une instance de DecoderReplacementFallback, les méthodes d’encodage et de dé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 ou DecoderReplacementFallback.DecoderReplacementFallback(String) le EncoderReplacementFallback.EncoderReplacementFallback(String) constructeur, vous pouvez spécifier la chaîne de remplacement.

• Meilleure solution de secours. Vous pouvez dériver de la ou DecoderFallback de la EncoderFallback classe 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 à le remplacer. Lorsque le code utilisateur tente de récupérer un encodage en appelant la GetEncoding(Int32, EncoderFallback, DecoderFallback) méthode, la méthode transmet l’identificateur codepage à chaque fournisseur d’encodage inscrit jusqu’à ce que l’on retourne un encodage valide. Si aucun ne retourne un encodage valide, la méthode tente de récupérer un encodage mis en cache dont l’identificateur GetEncoding(Int32) de page de codes est codepage. En raison de cela, si vous choisissez de remplacer la GetEncoding(Int32, EncoderFallback, DecoderFallback) méthode, votre remplacement doit retourner null si codepage ce n’est pas l’identificateur de page de codes 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)

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

Retours

Encodage associé au nom spécifié, ou null s’il EncodingProvider ne peut pas retourner un encodage valide correspondant à name.

Remarques

Les encoderFallback paramètres et decoderFallback les objets 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 un décodeur ne peut pas convertir une séquence d’octets en un caractère. .NET fournit les mécanismes de secours suivants :

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

• Secours de remplacement. Si l’argument encoderFallback est une instance de EncoderReplacementFallback, ou si l’argument decoderExceptionFallback est une instance de DecoderReplacementFallback, les méthodes d’encodage et de dé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 ou DecoderReplacementFallback.DecoderReplacementFallback(String) le EncoderReplacementFallback.EncoderReplacementFallback(String) constructeur, vous pouvez spécifier la chaîne de remplacement.

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

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)