Teilen über


EncodingProvider.GetEncoding Methode

Definition

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
Quelle:
EncodingProvider.cs
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);
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

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

Gilt für:

GetEncoding(String)

Quelle:
EncodingProvider.cs
Quelle:
EncodingProvider.cs
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);
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

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

Gilt für:

GetEncoding(Int32, EncoderFallback, DecoderFallback)

Quelle:
EncodingProvider.cs
Quelle:
EncodingProvider.cs
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);
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

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:

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

Gilt für:

GetEncoding(String, EncoderFallback, DecoderFallback)

Quelle:
EncodingProvider.cs
Quelle:
EncodingProvider.cs
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);
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

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:

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

Gilt für: