EncodingProvider.GetEncoding Método

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

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)

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

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)

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

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

Origem:

EncodingProvider.cs

Origem:

EncodingProvider.cs

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

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)