EncodingProvider.GetEncoding EncodingProvider.GetEncoding EncodingProvider.GetEncoding EncodingProvider.GetEncoding Method

Definition

Returns an encoding.

Overloads

GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Returns the encoding associated with the specified code page identifier.

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Returns the encoding with the specified name.

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Returns the encoding associated with the specified code page identifier. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Returns the encoding associated with the specified name. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32) GetEncoding(Int32)

Returns the encoding associated with the specified code page identifier.

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

Parameters

codepage
Int32 Int32 Int32 Int32

The code page identifier of the requested encoding.

Returns

The encoding that is associated with the specified code page, or null if this EncodingProvider cannot return a valid encoding that corresponds to codepage.

Remarks

Notes to inheritors

You override the GetEncoding(Int32) method to return the encoding or encodings supported by your EncodingProvider subclass. When user code attempts to retrieve an encoding by calling the GetEncoding(Int32) method, the method passes the codepage identifier to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Because of this, if codepage is not the code page identifier of an encoding that you support, the method should return null; it should never throw an exception.

Note that you can also choose to return a default code page if the value of the codepage argument is 0.

Notes to callers

This method is called by the Encoding.GetEncoding(Int32) method. You should not call it directly from user code.

Notes to Inheritors

You override the GetEncoding(Int32) method to return the encoding or encodings supported by your EncodingProvider subclass. When user code attempts to retrieve an encoding by calling the GetEncoding(Int32) method, the method passes the codepage identifier to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Because of this, if codepage is not the code page identifier of an encoding that you support, the method should return null; it should never throw an exception.

Notes to Callers

This method is called by the GetEncoding(Int32) method. You should not call it directly from user code.

See also

GetEncoding(String) GetEncoding(String) GetEncoding(String) GetEncoding(String)

Returns the encoding with the specified name.

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

Parameters

name
String String String String

The name of the requested encoding.

Returns

The encoding that is associated with the specified name, or null if this EncodingProvider cannot return a valid encoding that corresponds to name.

Remarks

Notes to inheritors

You override the GetEncoding(String) method to return the encoding or encodings supported by your EncodingProvider subclass. When user code attempts to retrieve an encoding by calling the GetEncoding(String) method, the method passes the name argument to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(String) method attempts to retrieve a cached encoding whose name is name. Because of this, if name is not the name of an encoding that you support, the method should return null. The only case in which the method should throw an exception is if name is null.

Notes to callers

This method is called by the Encoding.GetEncoding(String) method. You should not call it directly from user code.

Notes to Inheritors

You override the GetEncoding(String) method to return the encoding or encodings supported by your EncodingProvider subclass. When user code attempts to retrieve an encoding by calling the GetEncoding(String) method, the method passes the name argument to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(String) method attempts to retrieve a cached encoding whose name is name. Because of this, if name is not the name of an encoding that you support, the method should return null. The only case in which the method should throw an exception is if name is null.

Notes to Callers

This method is called by the GetEncoding(String) method. You should not call it directly from user code.

See also

GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback) GetEncoding(Int32, EncoderFallback, DecoderFallback)

Returns the encoding associated with the specified code page identifier. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

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

Parameters

codepage
Int32 Int32 Int32 Int32

The code page identifier of the requested encoding.

encoderFallback
EncoderFallback EncoderFallback EncoderFallback EncoderFallback

An object that provides an error-handling procedure when a character cannot be encoded with this encoding.

decoderFallback
DecoderFallback DecoderFallback DecoderFallback DecoderFallback

An object that provides an error-handling procedure when a byte sequence cannot be decoded with this encoding.

Returns

The encoding that is associated with the specified code page, or null if this EncodingProvider cannot return a valid encoding that corresponds to codepage.

Remarks

The encoderFallback and decoderFallback parameters are objects that define the fallback strategy used in the event that an encoder cannot convert a character to a sequence of bytes or a decoder cannot convert a sequence of bytes to a character. The .NET Framework provides the following fallback mechanisms:

Notes to Inheritors

Because calls to this method use your implementation of the GetEncoding(Int32) method, you do not have to override it. When user code attempts to retrieve an encoding by calling the GetEncoding(Int32, EncoderFallback, DecoderFallback) method, the method passes the codepage identifier to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Because of this, if you do choose to override the GetEncoding(Int32, EncoderFallback, DecoderFallback) method, your override should return null if codepage is not the code page identifier of an encoding that you support; it should never throw an exception.

Notes to Callers

This method is called by the GetEncoding(Int32, EncoderFallback, DecoderFallback) method. You should not call it directly from user code.

See also

GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback) GetEncoding(String, EncoderFallback, DecoderFallback)

Returns the encoding associated with the specified name. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

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

Parameters

name
String String String String

The name of the preferred encoding.

encoderFallback
EncoderFallback EncoderFallback EncoderFallback EncoderFallback

An object that provides an error-handling procedure when a character cannot be encoded with this encoding.

decoderFallback
DecoderFallback DecoderFallback DecoderFallback DecoderFallback

An object that provides an error-handling procedure when a byte sequence cannot be decoded with the current encoding.

Returns

The encoding that is associated with the specified name, or null if this EncodingProvider cannot return a valid encoding that corresponds to name.

Remarks

The encoderFallback and decoderFallback parameters are objects that define the fallback strategy used in the event that an encoder cannot convert a character to a sequence of bytes or a decoder cannot convert a sequence of bytes to a character. The .NET Framework provides the following fallback mechanisms:

Notes to Inheritors

Because calls to this method use your implementation of the GetEncoding(String) method, you do not have to override it. When user code attempts to retrieve an encoding by calling the GetEncoding(String, EncoderFallback, DecoderFallback) method, the method passes the codepage identifier to every registered encoding provider until one returns a valid encoding. If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Because of this, if you do choose to override the GetEncoding(Int32, EncoderFallback, DecoderFallback) method, your override should return null if codepage is not the code page identifier of an encoding that you support; it should never throw an exception.

Notes to Callers

This method is called by the GetEncoding(String, EncoderFallback, DecoderFallback) method. You should not call it directly from user code.

See also

Applies to