EncodingProvider.GetEncoding Methode

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

public:
 abstract System::Text::Encoding ^ GetEncoding(int codepage);

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

Gibt zurück

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)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

public:
 abstract System::Text::Encoding ^ GetEncoding(System::String ^ name);

public abstract System.Text.Encoding GetEncoding(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

Gibt zurück

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)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

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);

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

Gibt zurück

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)

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

Quelle:

EncodingProvider.cs

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);

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

Gibt zurück

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)