EncodingProvider.GetEncoding Methode

Definition

Namespace:

System.Text

Assembly:

System.Runtime.dll

Gibt eine Codierung zurück.

Überlädt

GetEncoding(Int32)	Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.
GetEncoding(String)	Gibt die Codierung mit dem angegebenen Namen zurück.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.
GetEncoding(String, EncoderFallback, DecoderFallback)	Gibt die dem angegebenen Namen zugeordnete Codierung zurück. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.

GetEncoding(Int32)

Quelle:

EncodingProvider.cs

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück.

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.

Gibt zurück

Encoding

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.

Hinweise

Notizen für Anrufer

Diese Methode wird von der Encoding.GetEncoding(Int32) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(Int32) -Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte nulldie Methode zurückgeben, wenn codepage es sich nicht um den Codepage-Bezeichner einer von Ihnen unterstützten Codierung handelt. Sie sollte niemals eine Ausnahme auslösen.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(Int32)

GetEncoding(String)

Quelle:

EncodingProvider.cs

Gibt die Codierung mit dem angegebenen Namen zurück.

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.

Gibt zurück

Encoding

Die dem angegebenen Namen zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die name entspricht.

Hinweise

Hinweise zu Erben

Sie überschreiben die GetEncoding(String)- Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String)- Methode abzurufen, übergibt die -Methode das name Argument an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(String)- Methode, eine zwischengespeicherte Codierung abzurufen, deren Name lautet name. Aus diesem Grund sollte die -Methode zurückgeben, wenn name nicht der Name einer von Ihnen unterstützten Codierung ist null. Der einzige Fall, in dem die -Methode eine Ausnahme auslösen sollte, ist , wenn name ist null.

Notizen für Anrufer

Diese Methode wird von der Encoding.GetEncoding(String)- Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(String) -Methode, um die von Ihrer EncodingProvider Unterklasse unterstützte Codierung oder Codierung zurückzugeben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String) -Methode abzurufen, übergibt die -Methode das name Argument an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(String) -Methode, eine zwischengespeicherte Codierung abzurufen, deren Name lautet name. Aus diesem Grund sollte die -Methode zurückgeben, wenn name nicht der Name einer von Ihnen unterstützten Codierung ist null. Der einzige Fall, in dem die -Methode eine Ausnahme auslösen sollte, ist , wenn name ist null.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Quelle:

EncodingProvider.cs

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung zurück. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.

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

Parameter

codepage

Int32

Der Codepagebezeichner der angeforderten Codierung.

encoderFallback

EncoderFallback

Ein Objekt, das ein Verfahren zur Fehlerbehandlung bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.

decoderFallback

DecoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn eine Bytefolge nicht mit dieser Codierung decodiert werden kann.

Gibt zurück

Encoding

Die der angegebenen Codepage zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die codepage entspricht.

Hinweise

Die encoderFallback Parameter und decoderFallback sind Objekte, die die Fallbackstrategie definieren, die für den Fall verwendet wird, dass ein Encoder ein Zeichen nicht in eine Bytesequenz konvertieren kann oder ein Decoder eine Bytesequenz nicht in ein Zeichen konvertieren kann. Die .NET Framework bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn das encoderFallback Argument ein instance von EncoderExceptionFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderExceptionFallbackist, löst die Codierungsmethode eine Ausnahme aus, wenn Zeichen nicht codiert werden können, und die Decodierungsmethode löst eine Ausnahme aus, wenn eine Bytesequenz nicht decodiert werden kann.

• Ersatzfallback. Wenn das encoderFallback Argument ein instance von EncoderReplacementFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderReplacementFallbackist, ersetzen die Codierungs- und Decodierungsmethoden eine Ersatzzeichenfolge für Zeichen, die nicht codiert werden können, und Bytesequenzen können nicht decodiert werden. Wenn Sie das Ersatzfallbackobjekt instanziiert haben, indem Sie den parameterlosen Konstruktor aufrufen, ist das Ersatzzeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor oder DecoderReplacementFallback.DecoderReplacementFallback(String) aufrufen, können Sie die Ersatzzeichenfolge angeben.

• Am besten geeignetes Fallback. Sie können von der EncoderFallback -Klasse oder DecoderFallback ableiten, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Vererber

Da Aufrufe dieser Methode Ihre Implementierung der GetEncoding(Int32) Methode verwenden, müssen Sie sie nicht überschreiben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte die Überschreibung der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode zurückgegeben null werden, wenn codepage nicht der Codepage-Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte niemals eine Ausnahme ausgelöst werden.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(Int32, EncoderFallback, DecoderFallback)

GetEncoding(String, EncoderFallback, DecoderFallback)

Quelle:

EncodingProvider.cs

Gibt die dem angegebenen Namen zugeordnete Codierung zurück. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und für Bytefolgen, die nicht decodiert werden können.

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

Parameter

name

String

Der Name der bevorzugten Codierung.

encoderFallback

EncoderFallback

Ein Objekt, das ein Verfahren zur Fehlerbehandlung bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.

decoderFallback

DecoderFallback

Ein Objekt, das ein Fehlerbehandlungsverfahren bereitstellt, wenn eine Bytefolge nicht mit der aktuellen Codierung decodiert werden kann.

Gibt zurück

Encoding

Die dem angegebenen Namen zugeordnete Codierung, oder null, wenn EncodingProvider keine gültige Codierung zurückgeben kann, die name entspricht.

Hinweise

Die encoderFallback Parameter und decoderFallback sind Objekte, die die Fallbackstrategie definieren, die für den Fall verwendet wird, dass ein Encoder ein Zeichen nicht in eine Bytesequenz konvertieren kann oder ein Decoder eine Bytesequenz nicht in ein Zeichen konvertieren kann. Die .NET Framework bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn das encoderFallback Argument ein instance von EncoderExceptionFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderExceptionFallbackist, löst die Codierungsmethode eine Ausnahme aus, wenn Zeichen nicht codiert werden können, und die Decodierungsmethode löst eine Ausnahme aus, wenn eine Bytesequenz nicht decodiert werden kann.

• Ersatzfallback. Wenn das encoderFallback Argument ein instance von EncoderReplacementFallbackist oder das decoderExceptionFallback Argument ein instance von DecoderReplacementFallbackist, ersetzen die Codierungs- und Decodierungsmethoden eine Ersatzzeichenfolge für Zeichen, die nicht codiert werden können, und Bytesequenzen können nicht decodiert werden. Wenn Sie das Ersatzfallbackobjekt instanziiert haben, indem Sie den parameterlosen Konstruktor aufrufen, ist das Ersatzzeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor oder DecoderReplacementFallback.DecoderReplacementFallback(String) aufrufen, können Sie die Ersatzzeichenfolge angeben.

• Am besten geeignetes Fallback. Sie können von der EncoderFallback -Klasse oder DecoderFallback ableiten, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Vererber

Da Aufrufe dieser Methode Ihre Implementierung der GetEncoding(String) Methode verwenden, müssen Sie sie nicht überschreiben. Wenn der Benutzercode versucht, eine Codierung durch Aufrufen der GetEncoding(String, EncoderFallback, DecoderFallback) -Methode abzurufen, übergibt die -Methode den codepage Bezeichner an jeden registrierten Codierungsanbieter, bis eine gültige Codierung zurückgegeben wird. Wenn keine eine gültige Codierung zurückgibt, versucht die GetEncoding(Int32) Methode, eine zwischengespeicherte Codierung abzurufen, deren Codepagebezeichner ist codepage. Aus diesem Grund sollte die Überschreibung der GetEncoding(Int32, EncoderFallback, DecoderFallback) -Methode zurückgegeben null werden, wenn codepage nicht der Codepage-Bezeichner einer von Ihnen unterstützten Codierung ist. Es sollte niemals eine Ausnahme ausgelöst werden.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String, EncoderFallback, DecoderFallback) -Methode aufgerufen. Sie sollten es nicht direkt über Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String, EncoderFallback, DecoderFallback)