EncodingProvider.GetEncoding Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

mscorlib.dll

Devuelve una codificación.

Sobrecargas

Nombre	Description
GetEncoding(Int32)	Devuelve la codificación asociada al identificador de página de códigos especificado.
GetEncoding(String)	Devuelve la codificación con el nombre especificado.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.
GetEncoding(String, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada al nombre especificado. Los parámetros especifican un controlador de errores para caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.

GetEncoding(Int32)

Devuelve la codificación asociada al identificador de página de códigos especificado.

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

Identificador de página de códigos de la codificación solicitada.

Devoluciones

Encoding

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)

GetEncoding(String)

Devuelve la codificación con el nombre 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

Nombre de la codificación solicitada.

Devoluciones

Encoding

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)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.

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

Identificador de página de códigos de la codificación solicitada.

encoderFallback

EncoderFallback

Objeto que proporciona un procedimiento de control de errores cuando un carácter no se puede codificar con esta codificación.

decoderFallback

DecoderFallback

Objeto que proporciona un procedimiento de control de errores cuando una secuencia de bytes no se puede descodificar con esta codificación.

Devoluciones

Encoding

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)

GetEncoding(String, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada al nombre especificado. Los parámetros especifican un controlador de errores para caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.

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

Nombre de la codificación preferida.

encoderFallback

EncoderFallback

Objeto que proporciona un procedimiento de control de errores cuando un carácter no se puede codificar con esta codificación.

decoderFallback

DecoderFallback

Objeto que proporciona un procedimiento de control de errores cuando una secuencia de bytes no se puede descodificar con la codificación actual.

Devoluciones

Encoding

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)