EncodingProvider.GetEncoding Methode

Definition

Gibt eine Codierung zurück.Returns an encoding.

Überlädt

GetEncoding(Int32)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.Returns the encoding associated with the specified code page identifier.

GetEncoding(String)

Gibt die Codierung mit dem angegebenen Namen zurück.Returns the encoding with the specified name.

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.Returns the encoding associated with the specified code page identifier. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(String, EncoderFallback, DecoderFallback)

Gibt die Codierung mit dem angegebenen Namen zurück.Returns the encoding associated with the specified name. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.

GetEncoding(Int32)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.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

Parameter

codepage
Int32

Der Codepagebezeichner der angeforderten Codierung.The code page identifier of the requested encoding.

Gibt zurück

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.The encoding that is associated with the specified code page, or null if this EncodingProvider cannot return a valid encoding that corresponds to codepage.

Hinweise

Hinweise für VererberNotes to inheritors

Sie überschreiben die GetEncoding (Int32) -Methode, um die von der EncodingProvider Unterklasse unterstützten Codierungen oder Codierungen zurückzugeben.You override the GetEncoding(Int32) method to return the encoding or encodings supported by your EncodingProvider subclass. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding (Int32) -Methode abzurufen, übergibt die Methode den codepage Bezeichner an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn None eine gültige Codierung zurückgibt, versucht die GetEncoding (Int32) -Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepage-Bezeichner codepageist.If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Wenn codepage nicht der Code Page Bezeichner einer Codierung ist, die Sie unterstützen, sollte die Methode daher nullzurückgeben. Es sollte nie eine Ausnahme ausgelöst werden.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.

Beachten Sie, dass Sie auch eine Standard Codepage zurückgeben können, wenn der Wert des codepage-Arguments 0 (null) ist.Note that you can also choose to return a default code page if the value of the codepage argument is 0.

Hinweise zu AufrufernNotes to callers

Diese Methode wird von der Encoding. GetEncoding (Int32) -Methode aufgerufen.This method is called by the Encoding.GetEncoding(Int32) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(Int32)-Methode, um die von ihrer EncodingProvider-Unterklasse unterstützten Codierungen oder Codierungen zurückzugeben.You override the GetEncoding(Int32) method to return the encoding or encodings supported by your EncodingProvider subclass. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32)-Methode abzurufen, übergibt die Methode den codepage Bezeichner an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn keine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepage-Bezeichner codepageist.If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Wenn codepage nicht der Code Page Bezeichner einer Codierung ist, die Sie unterstützen, sollte die Methode daher nullzurückgeben. Es sollte nie eine Ausnahme ausgelöst werden.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.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32)-Methode aufgerufen.This method is called by the GetEncoding(Int32) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Siehe auch

GetEncoding(String)

Gibt die Codierung mit dem angegebenen Namen zurück.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

Parameter

name
String

Der Name der angeforderten Codierung.The name of the requested encoding.

Gibt zurück

Die zum angegebenen Namen zugeordnete Codierung, oder null, wenn dieser EncodingProvider keine gültige Codierung liefern kann, die name entspricht.The encoding that is associated with the specified name, or null if this EncodingProvider cannot return a valid encoding that corresponds to name.

Hinweise

Hinweise für VererberNotes to inheritors

Sie überschreiben die GetEncoding (String) -Methode, um die von ihrer EncodingProvider-Unterklasse unterstützten Codierungen oder Codierungen zurückzugeben.You override the GetEncoding(String) method to return the encoding or encodings supported by your EncodingProvider subclass. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding (String) -Methode abzurufen, übergibt die Methode das name-Argument an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn None eine gültige Codierung zurückgibt, versucht die GetEncoding (String) -Methode, eine zwischengespeicherte Codierung abzurufen, deren Name nameist.If none returns a valid encoding, the GetEncoding(String) method attempts to retrieve a cached encoding whose name is name. Wenn name nicht der Name einer Codierung ist, die Sie unterstützen, sollte die Methode daher nullzurückgeben.Because of this, if name is not the name of an encoding that you support, the method should return null. Der einzige Fall, in dem die Methode eine Ausnahme auslösen sollte, ist, wenn name nullist.The only case in which the method should throw an exception is if name is null.

Hinweise zu AufrufernNotes to callers

Diese Methode wird von der Encoding. GetEncoding (String) -Methode aufgerufen.This method is called by the Encoding.GetEncoding(String) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(String)-Methode, um die von ihrer EncodingProvider-Unterklasse unterstützten Codierungen oder Codierungen zurückzugeben.You override the GetEncoding(String) method to return the encoding or encodings supported by your EncodingProvider subclass. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String)-Methode abzurufen, übergibt die Methode das name-Argument an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn None eine gültige Codierung zurückgibt, versucht die GetEncoding(String) Methode, eine zwischengespeicherte Codierung abzurufen, deren Name nameist.If none returns a valid encoding, the GetEncoding(String) method attempts to retrieve a cached encoding whose name is name. Wenn name nicht der Name einer Codierung ist, die Sie unterstützen, sollte die Methode daher nullzurückgeben.Because of this, if name is not the name of an encoding that you support, the method should return null. Der einzige Fall, in dem die Methode eine Ausnahme auslösen sollte, ist, wenn name nullist.The only case in which the method should throw an exception is if name is null.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String)-Methode aufgerufen.This method is called by the GetEncoding(String) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Siehe auch

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.Returns the encoding associated with the specified code page identifier. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.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

Parameter

codepage
Int32

Der Codepagebezeichner der angeforderten Codierung.The code page identifier of the requested encoding.

encoderFallback
EncoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.An object that provides an error-handling procedure when a character cannot be encoded with this encoding.

decoderFallback
DecoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn eine Bytefolge nicht mit dieser Codierung decodiert werden kann.An object that provides an error-handling procedure when a byte sequence cannot be decoded with this encoding.

Gibt zurück

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.The encoding that is associated with the specified code page, or null if this EncodingProvider cannot return a valid encoding that corresponds to codepage.

Hinweise

Die Parameter "encoderFallback" und "decoderFallback" sind Objekte, die die Fall Back Strategie definieren, die verwendet wird, wenn ein Encoder ein Zeichen nicht in eine Bytefolge konvertieren kann oder ein Decoder eine Bytefolge nicht in ein Zeichen konvertieren kann.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. Der .NET Framework stellt die folgenden Fall Back Mechanismen bereit:The .NET Framework provides the following fallback mechanisms:

Hinweise für Vererber

Da Aufrufe dieser Methode die Implementierung der GetEncoding(Int32)-Methode verwenden, müssen Sie Sie nicht überschreiben.Because calls to this method use your implementation of the GetEncoding(Int32) method, you do not have to override it. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32, EncoderFallback, DecoderFallback)-Methode abzurufen, übergibt die Methode den codepage Bezeichner an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn keine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepage-Bezeichner codepageist.If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Wenn Sie die GetEncoding(Int32, EncoderFallback, DecoderFallback)-Methode außer Kraft setzen, sollte Ihre außer Kraft Setzung null zurückgeben, wenn codepage nicht der Code Page Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte nie eine Ausnahme ausgelöst werden.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.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32, EncoderFallback, DecoderFallback)-Methode aufgerufen.This method is called by the GetEncoding(Int32, EncoderFallback, DecoderFallback) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Siehe auch

GetEncoding(String, EncoderFallback, DecoderFallback)

Gibt die Codierung mit dem angegebenen Namen zurück.Returns the encoding associated with the specified name. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.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

Parameter

name
String

Der Name der bevorzugten Codierung.The name of the preferred encoding.

encoderFallback
EncoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.An object that provides an error-handling procedure when a character cannot be encoded with this encoding.

decoderFallback
DecoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn eine Bytefolge nicht mit der aktuellen Codierung decodiert werden kann.An object that provides an error-handling procedure when a byte sequence cannot be decoded with the current encoding.

Gibt zurück

Die zum angegebenen Namen zugeordnete Codierung, oder null, wenn dieser EncodingProvider keine gültige Codierung liefern kann, die name entspricht.The encoding that is associated with the specified name, or null if this EncodingProvider cannot return a valid encoding that corresponds to name.

Hinweise

Die Parameter "encoderFallback" und "decoderFallback" sind Objekte, die die Fall Back Strategie definieren, die verwendet wird, wenn ein Encoder ein Zeichen nicht in eine Bytefolge konvertieren kann oder ein Decoder eine Bytefolge nicht in ein Zeichen konvertieren kann.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. Der .NET Framework stellt die folgenden Fall Back Mechanismen bereit:The .NET Framework provides the following fallback mechanisms:

Hinweise für Vererber

Da Aufrufe dieser Methode die Implementierung der GetEncoding(String)-Methode verwenden, müssen Sie Sie nicht überschreiben.Because calls to this method use your implementation of the GetEncoding(String) method, you do not have to override it. Wenn Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String, EncoderFallback, DecoderFallback)-Methode abzurufen, übergibt die Methode den codepage Bezeichner an jeden registrierten Codierungs Anbieter, bis eine gültige Codierung zurückgegeben wird.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. Wenn keine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepage-Bezeichner codepageist.If none returns a valid encoding, the GetEncoding(Int32) method attempts to retrieve a cached encoding whose code page identifier is codepage. Wenn Sie die GetEncoding(Int32, EncoderFallback, DecoderFallback)-Methode außer Kraft setzen, sollte Ihre außer Kraft Setzung null zurückgeben, wenn codepage nicht der Code Page Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte nie eine Ausnahme ausgelöst werden.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.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String, EncoderFallback, DecoderFallback)-Methode aufgerufen.This method is called by the GetEncoding(String, EncoderFallback, DecoderFallback) method. Sie sollten Sie nicht direkt aus Benutzercode abrufen.You should not call it directly from user code.

Siehe auch

Gilt für: