EncodingProvider.GetEncoding Método

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Devuelve una codificación.

Sobrecargas

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 los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.
GetEncoding(String, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada con el nombre especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.

GetEncoding(Int32)

Source:

EncodingProvider.cs

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 EncodingProvider no puede devolver una codificación válida que corresponda a codepage.

Comentarios

Notas a los autores de llamadas

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 la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación mediante una llamada 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. Por este motivo, si codepage no es el identificador de página de códigos de una codificación que admita, el método debe devolver null; nunca debería producir 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)

Source:

EncodingProvider.cs

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 EncodingProvider si null no puede devolver una codificación válida que corresponda a name.

Comentarios

Notas a los heredadores

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 mediante una llamada al método GetEncoding(String), el método pasa el name argumento 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 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 admita, 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 llamadas

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 la codificación o codificaciones admitidas por la EncodingProvider subclase. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(String) método , el método pasa el name argumento a cada proveedor de codificación registrado hasta que uno devuelva 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 admita, 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)

Source:

EncodingProvider.cs

Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las 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 no se puede codificar un carácter 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 EncodingProvider no 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 el 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 no se pueden codificar caracteres 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 DecoderReplacementFallback, los métodos de codificació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 mediante una llamada 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 GetEncoding(Int32) implementación del método , no es necesario invalidarlo. Cuando el código de usuario intenta recuperar una codificación mediante una llamada 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 admita; 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)

Source:

EncodingProvider.cs

Devuelve la codificación asociada con el nombre especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las 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 no se puede codificar un carácter 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 EncodingProvider si null no 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 el 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 no se pueden codificar caracteres 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 DecoderReplacementFallback, los métodos de codificació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 mediante una llamada 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 GetEncoding(String) implementación del método , no es necesario invalidarlo. Cuando el código de usuario intenta recuperar una codificación mediante una llamada al GetEncoding(String, 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 admita; nunca debería producir una excepción.

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)