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

Devoluções

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

Observações

Notas para quem telefona

Este método é chamado pelo método Encoding.GetEncoding(Int32). Não deves chamá-lo diretamente do código do utilizador.

Notas para Implementadores

Sobrescreves o GetEncoding(Int32) método para devolver a codificação ou codificações suportadas pela tua EncodingProvider subclasse. Quando o código de utilizador tenta recuperar uma codificação chamando o GetEncoding(Int32) método, o método passa o codepage identificador a todos os fornecedores de codificação registados até que um devolva uma codificação válida. Se none devolver uma codificação válida, o GetEncoding(Int32) método tenta recuperar uma codificação em cache cujo identificador de página de código seja codepage. Por causa disso, se codepage não for o identificador da página de código de uma codificação que suporta, o método deve devolver null; nunca deve lançar uma exceção.

Notas para Chamadores

Este método é chamado pelo GetEncoding(Int32) método. Não deves chamá-lo diretamente do código do utilizador.

Ver 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

Devoluções

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

Observações

Notas aos herdeiros

Sobrepões o método GetEncoding(String) para devolver a codificação ou codificações suportadas pela tua EncodingProvider subclasse. Quando o código de utilizador tenta recuperar uma codificação chamando o método GetEncoding(String), o método passa o name argumento a todos os fornecedores de codificação registados até que um devolva uma codificação válida. Se nenhum devolver uma codificação válida, o método GetEncoding(String) tenta recuperar uma codificação em cache cujo nome seja name. Por causa disso, se name não for o nome de uma codificação que suporta, o método deverá devolver null. O único caso em que o método deve lançar uma exceção é se name for null.

Notas para quem telefona

Este método é chamado pelo método Encoding.GetEncoding(String). Não deves chamá-lo diretamente do código do utilizador.

Notas para Implementadores

Sobrescreves o GetEncoding(String) método para devolver a codificação ou codificações suportadas pela tua EncodingProvider subclasse. Quando o código de utilizador tenta recuperar uma codificação chamando o GetEncoding(String) método, o método transmite o name argumento a todos os fornecedores de codificação registados até que um devolva uma codificação válida. Se nenhum devolver uma codificação válida, o GetEncoding(String) método tenta recuperar uma codificação em cache cujo nome é name. Por causa disso, se name não for o nome de uma codificação que suporta, o método deverá devolver null. O único caso em que o método deve lançar uma exceção é se name for null.

Notas para Chamadores

Este método é chamado pelo GetEncoding(String) método. Não deves chamá-lo diretamente do código do utilizador.

Ver 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

Devoluções

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

Observações

Os encoderFallback parâmetros e decoderFallback são objetos que definem a estratégia de recuo usada no caso de um codificador não conseguir converter um carácter numa sequência de bytes ou um descodificador não conseguir converter uma sequência de bytes num carácter. .NET Framework fornece os seguintes mecanismos de recurso:

• Exceção de recurso. 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 lança uma exceção se os caracteres não puderem ser codificados, e o método de descodificação lança uma exceção se uma sequência de bytes não puder ser descodificada.

• Recuo de substituição. Se o encoderFallback argumento for uma instância de EncoderReplacementFallback, ou o decoderExceptionFallback argumento for uma instância de DecoderReplacementFallback, os métodos de codificação e descodificação substituem caracteres que não podem ser codificados por uma cadeia de substituição e as sequências de bytes não podem ser descodificadas. Se instanciaste o objeto de substituição chamando o construtor sem parâmetros, o carácter substituto é um "?". Se chamares o EncoderReplacementFallback.EncoderReplacementFallback(String) constructor ou DecoderReplacementFallback.DecoderReplacementFallback(String) , podes especificar a cadeia de substituição.

• O plano B mais adequado. Pode derivar da EncoderFallback classe ou DecoderFallback para implementar um mecanismo de substituição que se ajuste melhor.

Notas para Herdeiros

Como as chamadas a este método usam a sua implementação GetEncoding(Int32) do método, não precisa de o sobrepor. Quando o código de utilizador tenta recuperar uma codificação chamando o GetEncoding(Int32, EncoderFallback, DecoderFallback) método, o método passa o codepage identificador a todos os fornecedores de codificação registados até que um devolva uma codificação válida. Se none devolver uma codificação válida, o GetEncoding(Int32) método tenta recuperar uma codificação em cache cujo identificador de página de código seja codepage. Por isso, se optar por sobrescrever o GetEncoding(Int32, EncoderFallback, DecoderFallback) método, o seu sobreposição deve devolver null se codepage não for o identificador da página de código de uma codificação que suporta; nunca deve lançar uma exceção.

Notas para Chamadores

Este método é chamado pelo GetEncoding(Int32, EncoderFallback, DecoderFallback) método. Não deves chamá-lo diretamente do código do utilizador.

Ver 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

Devoluções

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

Observações

Os encoderFallback parâmetros e decoderFallback são objetos que definem a estratégia de recuo usada no caso de um codificador não conseguir converter um carácter numa sequência de bytes ou um descodificador não conseguir converter uma sequência de bytes num carácter. O .NET fornece os seguintes mecanismos de recurso:

• Exceção de recurso. 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 lança uma exceção se os caracteres não puderem ser codificados, e o método de descodificação lança uma exceção se uma sequência de bytes não puder ser descodificada.

• Recuo de substituição. Se o encoderFallback argumento for uma instância de EncoderReplacementFallback, ou o decoderExceptionFallback argumento for uma instância de DecoderReplacementFallback, os métodos de codificação e descodificação substituem caracteres que não podem ser codificados por uma cadeia de substituição e as sequências de bytes não podem ser descodificadas. Se instanciaste o objeto de substituição chamando o construtor sem parâmetros, o carácter substituto é um "?". Se chamares o EncoderReplacementFallback.EncoderReplacementFallback(String) constructor ou DecoderReplacementFallback.DecoderReplacementFallback(String) , podes especificar a cadeia de substituição.

• O plano B mais adequado. Pode derivar da EncoderFallback classe ou DecoderFallback para implementar um mecanismo de substituição que se ajuste melhor.

Notas para Chamadores

Este método é chamado pelo GetEncoding(String, EncoderFallback, DecoderFallback) método. Não deves chamá-lo diretamente do código do utilizador.

Ver também

• GetEncoding(String, EncoderFallback, DecoderFallback)