EncodingProvider.GetEncoding Methode

Definition

Namespace:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Gibt eine Codierung zurück.

Überlädt

Name	Beschreibung
GetEncoding(Int32)	Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist.
GetEncoding(String)	Gibt die Codierung mit dem angegebenen Namen zurück.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und Bytesequenzen, 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 Bytesequenzen, die nicht decodiert werden können.

GetEncoding(Int32)

Quelle:

EncodingProvider.cs

Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist.

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 Codeseitenbezeichner der angeforderten Codierung.

Gibt zurück

Encoding

Die Codierung, die der angegebenen Codeseite zugeordnet ist, oder null wenn dies EncodingProvider keine gültige Codierung zurückgeben kann, die entspricht codepage.

Hinweise

Hinweise für Aufrufer

Diese Methode wird von der Encoding.GetEncoding(Int32)- Methode aufgerufen. Sie sollten sie nicht direkt aus Dem Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(Int32) Methode, um die von Ihrer EncodingProvider Unterklasse unterstützten Codierungen oder Codierungen 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 Codeseitenbezeichner lautet codepage. Wenn dies codepage nicht der Codeseitenbezeichner einer von Ihnen unterstützten Codierung ist, sollte die Methode zurückgegeben werden. Die Methode sollte niemals eine Ausnahme auslösen null.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32) Methode aufgerufen. Sie sollten sie nicht direkt aus Dem 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 Codierung, die dem angegebenen Namen zugeordnet ist, oder null wenn dies EncodingProvider keine gültige Codierung zurückgeben kann, die entspricht name.

Hinweise

Hinweise zu Vererbungen

Sie überschreiben die GetEncoding(String) -Methode, um die von Ihrer EncodingProvider Unterklasse unterstützten Codierungen oder Codierungen 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. Wenn dies name nicht der Name einer von Ihnen unterstützten Codierung ist, sollte die Methode zurückgegeben werden null. Der einzige Fall, in dem die Methode eine Ausnahme auslösen soll, ist dies nameder null Fall.

Hinweise für Aufrufer

Diese Methode wird von der Encoding.GetEncoding(String)- Methode aufgerufen. Sie sollten sie nicht direkt aus Dem Benutzercode aufrufen.

Hinweise für Ausführende

Sie überschreiben die GetEncoding(String) Methode, um die von Ihrer EncodingProvider Unterklasse unterstützten Codierungen oder Codierungen zurückzugeben. Wenn 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. Wenn dies name nicht der Name einer von Ihnen unterstützten Codierung ist, sollte die Methode zurückgegeben werden null. Der einzige Fall, in dem die Methode eine Ausnahme auslösen soll, ist dies nameder null Fall.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String) Methode aufgerufen. Sie sollten sie nicht direkt aus Dem Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String)

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Quelle:

EncodingProvider.cs

Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist. Parameter geben einen Fehlerhandler für Zeichen an, die nicht codiert werden können, und Bytesequenzen, 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 Codeseitenbezeichner der angeforderten Codierung.

encoderFallback

EncoderFallback

Ein Objekt, das eine Fehlerbehandlungsprozedur bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.

decoderFallback

DecoderFallback

Ein Objekt, das eine Fehlerbehandlungsprozedur bereitstellt, wenn eine Bytesequenz nicht mit dieser Codierung decodiert werden kann.

Gibt zurück

Encoding

Die Codierung, die der angegebenen Codeseite zugeordnet ist, oder null wenn dies EncodingProvider keine gültige Codierung zurückgeben kann, die entspricht codepage.

Hinweise

Bei encoderFallback den Parametern handelt decoderFallback es sich um Objekte, die die Fallbackstrategie definieren, die für den Fallback verwendet wird, dass ein Encoder ein Zeichen nicht in eine Folge von Bytes konvertieren kann oder ein Decoder keine Bytesequenz in ein Zeichen konvertieren kann. Das .NET Framework bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn es sich bei dem encoderFallback Argument um eine Instanz von EncoderExceptionFallback, oder das decoderExceptionFallback Argument um eine Instanz handelt DecoderExceptionFallback, 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 es sich bei dem encoderFallback Argument um eine Instanz von EncoderReplacementFallback, oder das decoderExceptionFallback Argument um eine Instanz handelt DecoderReplacementFallback, ersetzen die Codierungs- und Decodierungsmethoden eine Ersetzungszeichenfolge 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 Ersetzungszeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor aufrufen DecoderReplacementFallback.DecoderReplacementFallback(String) , können Sie die Ersetzungszeichenfolge angeben.

• Fallback am besten geeignet. Sie können von der Klasse oder EncoderFallback der DecoderFallback Klasse abgeleitet werden, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Vererber

Da Aufrufe dieser Methode die 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 Codeseitenbezeichner lautet codepage. Wenn Sie sich dafür entscheiden, die GetEncoding(Int32, EncoderFallback, DecoderFallback) Methode außer Kraft zu setzen, sollte die Außerkraftsetzung zurückgegeben null werden, wenn codepage es sich nicht um den Codeseitenbezeichner einer von Ihnen unterstützten Codierung handelt. Es sollte niemals eine Ausnahme auslösen.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(Int32, EncoderFallback, DecoderFallback) Methode aufgerufen. Sie sollten sie nicht direkt aus Dem 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 Bytesequenzen, 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 eine Fehlerbehandlungsprozedur bereitstellt, wenn ein Zeichen nicht mit dieser Codierung codiert werden kann.

decoderFallback

DecoderFallback

Ein Objekt, das eine Fehlerbehandlungsprozedur bereitstellt, wenn eine Bytesequenz nicht mit der aktuellen Codierung decodiert werden kann.

Gibt zurück

Encoding

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

Hinweise

Bei encoderFallback den Parametern handelt decoderFallback es sich um Objekte, die die Fallbackstrategie definieren, die für den Fallback verwendet wird, dass ein Encoder ein Zeichen nicht in eine Folge von Bytes konvertieren kann oder ein Decoder keine Bytesequenz in ein Zeichen konvertieren kann. .NET bietet die folgenden Fallbackmechanismen:

• Ausnahmefallback. Wenn es sich bei dem encoderFallback Argument um eine Instanz von EncoderExceptionFallback, oder das decoderExceptionFallback Argument um eine Instanz handelt DecoderExceptionFallback, 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 es sich bei dem encoderFallback Argument um eine Instanz von EncoderReplacementFallback, oder das decoderExceptionFallback Argument um eine Instanz handelt DecoderReplacementFallback, ersetzen die Codierungs- und Decodierungsmethoden eine Ersetzungszeichenfolge 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 Ersetzungszeichen ein "?". Wenn Sie den EncoderReplacementFallback.EncoderReplacementFallback(String) Konstruktor aufrufen DecoderReplacementFallback.DecoderReplacementFallback(String) , können Sie die Ersetzungszeichenfolge angeben.

• Fallback am besten geeignet. Sie können von der Klasse oder EncoderFallback der DecoderFallback Klasse abgeleitet werden, um einen am besten geeigneten Ersatzmechanismus zu implementieren.

Hinweise für Aufrufer

Diese Methode wird von der GetEncoding(String, EncoderFallback, DecoderFallback) Methode aufgerufen. Sie sollten sie nicht direkt aus Dem Benutzercode aufrufen.

Weitere Informationen

• GetEncoding(String, EncoderFallback, DecoderFallback)