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

Devoluciones

Codificación asociada a la página de códigos especificada o null si no EncodingProvider puede devolver una codificación válida que corresponda a codepage.

Comentarios

Notas para los llamadores

El método Encoding.GetEncoding(Int32) llama a este método. No debe llamarlo directamente desde el código de usuario.

Notas a los implementadores

Invalida el GetEncoding(Int32) método para devolver las codificaciones o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación llamando al GetEncoding(Int32) método , el método pasa el codepage identificador a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(Int32) método intenta recuperar una codificación almacenada en caché cuyo identificador de página de códigos es codepage. Debido a esto, si codepage no es el identificador de la página de códigos de una codificación compatible, el método debe devolver null; nunca debería iniciar una excepción.

Notas a los autores de las llamadas

El método llama a GetEncoding(Int32) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

• 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

Devoluciones

Codificación asociada al nombre especificado o null si no EncodingProvider puede devolver una codificación válida que corresponda a name.

Comentarios

Notas para los heredar

Invalida el método GetEncoding(String) para devolver la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación llamando al método GetEncoding(String), el método pasa el name argumento a todos los proveedores de codificación registrados hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el método GetEncoding(String) intenta recuperar una codificación almacenada en caché cuyo nombre es name. Por este motivo, si name no es el nombre de una codificación que admite, el método debe devolver null. El único caso en el que el método debe producir una excepción es si name es null.

Notas para los llamadores

El método Encoding.GetEncoding(String) llama a este método. No debe llamarlo directamente desde el código de usuario.

Notas a los implementadores

Invalida el GetEncoding(String) método para devolver las codificaciones o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación llamando al GetEncoding(String) método , el método pasa el name argumento a todos los proveedores de codificación registrados hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(String) método intenta recuperar una codificación almacenada en caché cuyo nombre es name. Por este motivo, si name no es el nombre de una codificación que admite, el método debe devolver null. El único caso en el que el método debe producir una excepción es si name es null.

Notas a los autores de las llamadas

El método llama a GetEncoding(String) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

• 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

Devoluciones

Codificación asociada a la página de códigos especificada o null si no EncodingProvider puede devolver una codificación válida que corresponda a codepage.

Comentarios

Los encoderFallback parámetros y decoderFallback son objetos que definen la estrategia de reserva utilizada en caso de que un codificador no pueda convertir un carácter en una secuencia de bytes o un descodificador no puede convertir una secuencia de bytes en un carácter. .NET Framework proporciona los siguientes mecanismos de reserva:

• Reserva de excepciones. Si el encoderFallback argumento es una instancia de EncoderExceptionFallback, o el decoderExceptionFallback argumento es una instancia de DecoderExceptionFallback, el método de codificación produce una excepción si los caracteres no se pueden codificar y el método de descodificación produce una excepción si no se puede descodificar una secuencia de bytes.

• Reserva de reemplazo. Si el encoderFallback argumento es una instancia de EncoderReplacementFallback, o el decoderExceptionFallback argumento es una instancia de , los métodos de DecoderReplacementFallbackcodificación y descodificación sustituyen una cadena de reemplazo por caracteres que no se pueden codificar y las secuencias de bytes no se pueden descodificar. Si creó una instancia del objeto de reserva de reemplazo llamando al constructor sin parámetros, el carácter de reemplazo es "?". Si llama al EncoderReplacementFallback.EncoderReplacementFallback(String) constructor o DecoderReplacementFallback.DecoderReplacementFallback(String) , puede especificar la cadena de reemplazo.

• Reserva más adecuada. Puede derivar de la EncoderFallback clase o DecoderFallback para implementar un mecanismo de reemplazo más adecuado.

Notas a los desarrolladores de herederos

Dado que las llamadas a este método usan la implementación del GetEncoding(Int32) método , no es necesario invalidarlo. Cuando el código de usuario intenta recuperar una codificación llamando al GetEncoding(Int32, EncoderFallback, DecoderFallback) método , el método pasa el codepage identificador a cada proveedor de codificación registrado hasta que uno devuelve una codificación válida. Si ninguno devuelve una codificación válida, el GetEncoding(Int32) método intenta recuperar una codificación almacenada en caché cuyo identificador de página de códigos es codepage. Por este motivo, si decide invalidar el GetEncoding(Int32, EncoderFallback, DecoderFallback) método, la invalidación debe devolver null si codepage no es el identificador de página de códigos de una codificación que admite; nunca debería producir una excepción.

Notas a los autores de las llamadas

El método llama a GetEncoding(Int32, EncoderFallback, DecoderFallback) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

• 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

Devoluciones

Codificación asociada al nombre especificado o null si no EncodingProvider puede devolver una codificación válida que corresponda a name.

Comentarios

Los encoderFallback parámetros y decoderFallback son objetos que definen la estrategia de reserva utilizada en caso de que un codificador no pueda convertir un carácter en una secuencia de bytes o un descodificador no puede convertir una secuencia de bytes en un carácter. .NET proporciona los siguientes mecanismos de reserva:

• Reserva de excepciones. Si el encoderFallback argumento es una instancia de EncoderExceptionFallback, o el decoderExceptionFallback argumento es una instancia de DecoderExceptionFallback, el método de codificación produce una excepción si los caracteres no se pueden codificar y el método de descodificación produce una excepción si no se puede descodificar una secuencia de bytes.

• Reserva de reemplazo. Si el encoderFallback argumento es una instancia de EncoderReplacementFallback, o el decoderExceptionFallback argumento es una instancia de , los métodos de DecoderReplacementFallbackcodificación y descodificación sustituyen una cadena de reemplazo por caracteres que no se pueden codificar y las secuencias de bytes no se pueden descodificar. Si creó una instancia del objeto de reserva de reemplazo llamando al constructor sin parámetros, el carácter de reemplazo es "?". Si llama al EncoderReplacementFallback.EncoderReplacementFallback(String) constructor o DecoderReplacementFallback.DecoderReplacementFallback(String) , puede especificar la cadena de reemplazo.

• Reserva más adecuada. Puede derivar de la EncoderFallback clase o DecoderFallback para implementar un mecanismo de reemplazo más adecuado.

Notas a los autores de las llamadas

El método llama a GetEncoding(String, EncoderFallback, DecoderFallback) este método. No debe llamarlo directamente desde el código de usuario.

Consulte también

• GetEncoding(String, EncoderFallback, DecoderFallback)