EncodingProvider.GetEncoding Método

Definição

Espaço de Nomes:

System.Text

Assemblagem:

mscorlib.dll

Devolve uma codificação.

Sobrecargas

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

GetEncoding(Int32)

Devolve a codificação associada ao identificador especificado da página de códigos.

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 da página de códigos da codificação solicitada.

Devoluções

Encoding

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)

GetEncoding(String)

Devolve 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.

Devoluções

Encoding

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)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao identificador especificado da página de códigos. Os parâmetros especificam um manipulador de erros 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 da página de códigos da codificação solicitada.

encoderFallback

EncoderFallback

Um objeto que fornece um procedimento de tratamento de erros quando um carácter não pode ser codificado com esta codificação.

decoderFallback

DecoderFallback

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

Devoluções

Encoding

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)

GetEncoding(String, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao nome especificado. Os parâmetros especificam um manipulador de erros 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 preferida.

encoderFallback

EncoderFallback

Um objeto que fornece um procedimento de tratamento de erros quando um carácter não pode ser codificado com esta codificação.

decoderFallback

DecoderFallback

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

Devoluções

Encoding

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)