EncodingProvider.GetEncoding Método

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

Retornos

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

Comentários

Notas para 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 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 nenhuma 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 deve 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)

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

Retornos

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

Comentários

Anotações aos herdadores

Você substitui o método GetEncoding(String) para retornar a codificação ou codificações com suporte pela subclasse EncodingProvider . 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 lançar uma exceção é se name for null.

Notas para 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 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 nenhuma 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 lançar 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)

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

Retornos

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

Comentários

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

• Fallback de exceção. Se o encoderFallback argumento for uma instância de EncoderExceptionFallback, ou 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 EncoderReplacementFallback, ou o decoderExceptionFallback argumento for uma instância, DecoderReplacementFallbackos métodos de codificaçã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 construtor ou o EncoderReplacementFallback.EncoderReplacementFallback(String) construtor DecoderReplacementFallback.DecoderReplacementFallback(String) , poderá especificar a cadeia de caracteres de substituição.

• Fallback de melhor ajuste. Você pode derivar da classe ou DecoderFallback da EncoderFallback classe 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 nenhuma 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)

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

Retornos

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

Comentários

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

• Fallback de exceção. Se o encoderFallback argumento for uma instância de EncoderExceptionFallback, ou 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 EncoderReplacementFallback, ou o decoderExceptionFallback argumento for uma instância, DecoderReplacementFallbackos métodos de codificaçã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 construtor ou o EncoderReplacementFallback.EncoderReplacementFallback(String) construtor DecoderReplacementFallback.DecoderReplacementFallback(String) , poderá especificar a cadeia de caracteres de substituição.

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

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)