EncodingProvider Klasse

Definition

Stellt die Basisklasse für einen Codierungsanbieter bereit, der Codierungen liefert, die auf einer bestimmten Plattform nicht verfügbar sind.

public ref class EncodingProvider abstract
public abstract class EncodingProvider
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvider
type EncodingProvider = class
[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = class
Public MustInherit Class EncodingProvider
Vererbung
EncodingProvider
Abgeleitet
Attribute

Hinweise

Ein Codierungsanbieter stellt Codierungen bereit, die auf einer bestimmten Zielplattform sonst nicht verfügbar sind.

Die .NET Framework unterstützt eine große Anzahl von Zeichencodierungen und Codepages. Sie können eine vollständige Liste der im .NET Framework verfügbaren Codierungen abrufen, indem Sie die Encoding.GetEncodings -Methode aufrufen. .NET Core unterstützt dagegen standardmäßig nur die folgenden Codierungen:

  • ASCII (Codepage 20127), das von der Encoding.ASCII -Eigenschaft zurückgegeben wird.

  • ISO-8859-1 (Codepage 28591).

  • UTF-7 (Codepage 65000), das von der Encoding.UTF7 -Eigenschaft zurückgegeben wird.

  • UTF-8 (Codepage 65001), das von der Encoding.UTF8 -Eigenschaft zurückgegeben wird.

  • UTF-16 und UTF-16LE (Codepage 1200), die von der Unicode -Eigenschaft zurückgegeben werden.

  • UTF-16BE (Codepage 1201), das durch Aufrufen des UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) Konstruktors oder UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) mit dem bigEndian Wert instanziiert truewird.

  • UTF-32 und UTF-32LE (Codepage 12000), die von der Encoding.UTF32 -Eigenschaft zurückgegeben werden.

  • UTF-32BE (Codepage 12001), das durch Aufrufen eines UTF32Encoding Konstruktors mit einem bigEndian Parameter instanziiert wird und im Methodenaufruf den Wert von true bereitstellt.

Ab dem .NET Framework 4.6 ist die Basisklasse, EncodingProvider die ansonsten nicht verfügbare Codierungen für den .NET Framework zur Verfügung stellt. Dieser Vorgang umfasst die folgenden Schritte:

  1. Definieren Sie eine Unterklasse von, EncodingProvider die die beiden abstrakten GetEncoding Überladungen überschreibt, GetEncoding(Int32) und GetEncoding(String). Diese Überladungen geben die ansonsten nicht unterstützte Codierung nach Codepagebezeichner und Name zurück. Beachten Sie, dass Sie auch eine Standardcodierung zurückgeben können, wenn die GetEncoding(Int32) Methode mit dem Argument 0 aufgerufen wird.

  2. Optional können Sie die virtuellen GetEncoding(Int32, EncoderFallback, DecoderFallback) Methoden und GetEncoding(String, EncoderFallback, DecoderFallback) überschreiben. In den meisten Fällen ist dies nicht erforderlich, da die Basisklasse eine Standardimplementierung bereitstellt.

  3. Übergeben Sie die EncodingProvider instance an die Encoding.RegisterProvider -Methode, um die vom EncodingProvider -Objekt bereitgestellten Codierungen für die Common Language Runtime verfügbar zu machen.

  4. Rufen Sie eine Encoding.GetEncoding Überladung auf, um die Codierung abzurufen. Die Encoding.GetEncoding -Methode ruft den entsprechenden EncodingProvider.GetEncoding auf, um zu bestimmen, ob sie die angeforderte Codierung bereitstellen kann.

Die .NET Framework-Klassenbibliothek stellt eine statische Eigenschaft ( ) bereit, CodePagesEncodingProvider.Instancedie ein EncodingProvider Objekt zurückgibt, das den vollständigen Satz von Codierungen auf dem Desktop .NET Framework Klassenbibliothek für .NET Core-Anwendungen verfügbar macht. Darüber hinaus können Sie von der EncodingProvider -Klasse ableiten, um Ihre eigenen Codierungen verfügbar zu machen.

Konstruktoren

EncodingProvider()

Initialisiert eine neue Instanz der EncodingProvider-Klasse.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetEncoding(Int32)

Gibt die dem angegebenen Codepagebezeichner zugeordnete Codierung 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)

Gibt die Codierung mit dem angegebenen Namen zurück.

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.

GetEncodings()

Diese Methode gibt ein Array zurück, das alle Codierungen enthält, die von der EncodingProvider-Klasse unterstützt werden.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen