EncodingProvider.GetEncoding Método

Definição

Namespace:

System.Text

Assembly:

System.Runtime.dll

Retorna uma codificação.

Sobrecargas

GetEncoding(Int32)	Retorna a codificação associada ao identificador de página de código especificado.
GetEncoding(String)	Retorna a codificação com o nome especificado.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Retorna a codificação associada ao identificador de página de código especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.
GetEncoding(String, EncoderFallback, DecoderFallback)	Retorna a codificação associada ao nome especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.

GetEncoding(Int32)

Origem:

EncodingProvider.cs

Retorna a codificação associada ao identificador de página de código especificado.

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

Parâmetros

codepage

Int32

O identificador de página de código da codificação solicitada.

Retornos

Encoding

A codificação associada à página de código especificada ou null, se este EncodingProvider não puder retornar uma codificação válida que corresponde ao codepage.

Comentários

Anotações aos chamadores

Esse método é chamado pelo método Encoding.GetEncoding(Int32). Você não deve chamá-lo diretamente do código do usuário.

Notas aos Implementadores

Substitua o GetEncoding(Int32) método para retornar a codificação ou as codificações compatíveis com sua EncodingProvider subclasse. Quando o código do usuário tenta recuperar uma codificação chamando o GetEncoding(Int32) método , o método passa o codepage identificador para cada provedor de codificação registrado até que um retorne uma codificação válida. Se nenhum retornar uma codificação válida, o GetEncoding(Int32) método tentará recuperar uma codificação armazenada em cache cujo identificador de página de código é codepage. Por isso, se codepage não for o identificador de página de código de uma codificação compatível, o método deverá retornar null; ele nunca deverá gerar uma exceção.

Notas aos Chamadores

Esse método é chamado pelo GetEncoding(Int32) método . Você não deve chamá-lo diretamente do código do usuário.

Confira também

• GetEncoding(Int32)

GetEncoding(String)

Origem:

EncodingProvider.cs

Retorna a codificação com o nome especificado.

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

Parâmetros

name

String

O nome da codificação solicitada.

Retornos

Encoding

A codificação associada ao nome especificado ou null se este EncodingProvider não puder retornar uma codificação válida que corresponde ao name.

Comentários

Anotações aos herdadores

Substitua o método GetEncoding(String) para retornar a codificação ou as codificações compatíveis com sua EncodingProvider subclasse. Quando o código do usuário tenta recuperar uma codificação chamando o método GetEncoding(String), o método passa o name argumento para cada provedor de codificação registrado até que um retorne uma codificação válida. Se nenhum retornar uma codificação válida, o método GetEncoding(String) tentará recuperar uma codificação armazenada em cache cujo nome é name. Por isso, se name não for o nome de uma codificação compatível, o método deverá retornar null. O único caso em que o método deve gerar uma exceção é se name for null.

Anotações aos chamadores

Esse método é chamado pelo método Encoding.GetEncoding(String). Você não deve chamá-lo diretamente do código do usuário.

Notas aos Implementadores

Substitua o GetEncoding(String) método para retornar a codificação ou as codificações compatíveis com sua EncodingProvider subclasse. Quando o código do usuário tenta recuperar uma codificação chamando o GetEncoding(String) método , o método passa o name argumento para cada provedor de codificação registrado até que um retorne uma codificação válida. Se nenhum retornar uma codificação válida, o GetEncoding(String) método tentará recuperar uma codificação armazenada em cache cujo nome é name. Por isso, se name não for o nome de uma codificação compatível, o método deverá retornar null. O único caso em que o método deve gerar uma exceção é se name for null.

Notas aos Chamadores

Esse método é chamado pelo GetEncoding(String) método . Você não deve chamá-lo diretamente do código do usuário.

Confira também

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Origem:

EncodingProvider.cs

Retorna a codificação associada ao identificador de página de código especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.

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

Parâmetros

codepage

Int32

O identificador de página de código da codificação solicitada.

encoderFallback

EncoderFallback

Um objeto que fornece um procedimento de tratamento de erro quando um caractere não pode ser codificado com esta codificação.

decoderFallback

DecoderFallback

Um objeto que fornece um procedimento de tratamento de erro quando uma sequência de bytes não pode ser decodificada com esta codificação.

Retornos

Encoding

A codificação associada à página de código especificada ou null, se este EncodingProvider não puder retornar uma codificação válida que corresponde ao codepage.

Comentários

Os encoderFallback parâmetros e decoderFallback são objetos que definem a estratégia de fallback usada no caso de um codificador não conseguir converter um caractere em uma sequência de bytes ou um decodificador não pode converter uma sequência de bytes em um caractere. O .NET Framework fornece os seguintes mecanismos de fallback:

• Fallback de exceção. Se o encoderFallback argumento for uma instância de EncoderExceptionFallbackou o decoderExceptionFallback argumento for uma instância de DecoderExceptionFallback, o método de codificação gerará uma exceção se os caracteres não puderem ser codificados e o método de decodificação gerar uma exceção se uma sequência de bytes não puder ser decodificada.

• Fallback de substituição. Se o encoderFallback argumento for uma instância de EncoderReplacementFallbackou o decoderExceptionFallback argumento for uma instância de , os métodos de DecoderReplacementFallbackcodificação e decodificação substituirão uma cadeia de caracteres de substituição por caracteres que não podem ser codificados e sequências de bytes não poderão ser decodificadas. Se você instanciou o objeto de fallback de substituição chamando o construtor sem parâmetros, o caractere de substituição será um "?". Se você chamar o EncoderReplacementFallback.EncoderReplacementFallback(String) construtor ou DecoderReplacementFallback.DecoderReplacementFallback(String) , poderá especificar a cadeia de caracteres de substituição.

• Fallback de melhor ajuste. Você pode derivar da EncoderFallback classe ou DecoderFallback para implementar um mecanismo de substituição de melhor ajuste.

Notas aos Herdeiros

Como as chamadas para esse método usam a implementação do GetEncoding(Int32) método , você não precisa substituí-lo. Quando o código do usuário tenta recuperar uma codificação chamando o GetEncoding(Int32, EncoderFallback, DecoderFallback) método , o método passa o codepage identificador para cada provedor de codificação registrado até que um retorne uma codificação válida. Se nenhum retornar uma codificação válida, o GetEncoding(Int32) método tentará recuperar uma codificação armazenada em cache cujo identificador de página de código é codepage. Por isso, se você optar por substituir o GetEncoding(Int32, EncoderFallback, DecoderFallback) método , sua substituição deverá retornar null se codepage não for o identificador de página de código de uma codificação compatível; ela nunca deverá gerar uma exceção.

Notas aos Chamadores

Esse método é chamado pelo GetEncoding(Int32, EncoderFallback, DecoderFallback) método . Você não deve chamá-lo diretamente do código do usuário.

Confira também

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Origem:

EncodingProvider.cs

Retorna a codificação associada ao nome especificado. Os parâmetros especificam um manipulador de erro para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.

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

Parâmetros

name

String

O nome da codificação preferencial.

encoderFallback

EncoderFallback

Um objeto que fornece um procedimento de tratamento de erro quando um caractere não pode ser codificado com esta codificação.

decoderFallback

DecoderFallback

Um objeto que fornece um procedimento de tratamento de erro quando uma sequência de bytes não pode ser decodificada com a codificação atual.

Retornos

Encoding

A codificação associada ao nome especificado ou null se este EncodingProvider não puder retornar uma codificação válida que corresponde ao name.

Comentários

Os encoderFallback parâmetros e decoderFallback são objetos que definem a estratégia de fallback usada no caso de um codificador não conseguir converter um caractere em uma sequência de bytes ou um decodificador não pode converter uma sequência de bytes em um caractere. O .NET Framework fornece os seguintes mecanismos de fallback:

• Fallback de exceção. Se o encoderFallback argumento for uma instância de EncoderExceptionFallbackou o decoderExceptionFallback argumento for uma instância de DecoderExceptionFallback, o método de codificação gerará uma exceção se os caracteres não puderem ser codificados e o método de decodificação gerar uma exceção se uma sequência de bytes não puder ser decodificada.

• Fallback de substituição. Se o encoderFallback argumento for uma instância de EncoderReplacementFallbackou o decoderExceptionFallback argumento for uma instância de , os métodos de DecoderReplacementFallbackcodificação e decodificação substituirão uma cadeia de caracteres de substituição por caracteres que não podem ser codificados e sequências de bytes não poderão ser decodificadas. Se você instanciou o objeto de fallback de substituição chamando o construtor sem parâmetros, o caractere de substituição será um "?". Se você chamar o EncoderReplacementFallback.EncoderReplacementFallback(String) construtor ou DecoderReplacementFallback.DecoderReplacementFallback(String) , poderá especificar a cadeia de caracteres de substituição.

• Fallback de melhor ajuste. Você pode derivar da EncoderFallback classe ou DecoderFallback para implementar um mecanismo de substituição de melhor ajuste.

Notas aos Herdeiros

Como as chamadas para esse método usam a implementação do GetEncoding(String) método , você não precisa substituí-lo. Quando o código do usuário tenta recuperar uma codificação chamando o GetEncoding(String, EncoderFallback, DecoderFallback) método , o método passa o codepage identificador para cada provedor de codificação registrado até que um retorne uma codificação válida. Se nenhum retornar uma codificação válida, o GetEncoding(Int32) método tentará recuperar uma codificação armazenada em cache cujo identificador de página de código é codepage. Por isso, se você optar por substituir o GetEncoding(Int32, EncoderFallback, DecoderFallback) método , sua substituição deverá retornar null se codepage não for o identificador de página de código de uma codificação compatível; ela nunca deverá gerar uma exceção.

Notas aos Chamadores

Esse método é chamado pelo GetEncoding(String, EncoderFallback, DecoderFallback) método . Você não deve chamá-lo diretamente do código do usuário.

Confira também

• GetEncoding(String, EncoderFallback, DecoderFallback)