EncodingProvider.GetEncoding Método

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

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 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)

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

public abstract System.Text.Encoding GetEncoding (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 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)

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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);

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 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)

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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);

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 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)