EncodingProvider Klasse

Definition

Namespace:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

EncodingProvider.cs

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

public ref class EncodingProvider abstract

public abstract class EncodingProvider

type EncodingProvider = class

Public MustInherit Class EncodingProvider

Vererbung

Object

EncodingProvider

Abgeleitet

System.Text.CodePagesEncodingProvider

Hinweise

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

.NET Framework unterstützt eine große Anzahl von Zeichencodierungen und Codeseiten. Sie können eine vollständige Liste der in .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), die von der Encoding.ASCII Eigenschaft zurückgegeben wird.

• ISO-8859-1 (Codepage 28591).

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

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

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

• UTF-16BE (Codepage 1201), das durch Aufrufen des UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) Oder UnicodeEncoding.UnicodeEncoding(Boolean, Boolean) Konstruktors mit einem bigEndian Wert von true.

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

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

Ab .NET Framework 4.6 ist die Basisklasse, EncodingProvider die andernfalls nicht verfügbare Codierungen für .NET Framework verfügbar macht. Dieser Vorgang umfasst die folgenden Schritte:

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

2. Optional können Sie die virtuellen GetEncoding(Int32, EncoderFallback, DecoderFallback) Und GetEncoding(String, EncoderFallback, DecoderFallback) Methoden außer Kraft setzen. In den meisten Fällen ist dies nicht erforderlich, da die Basisklasse eine Standardimplementierung bereitstellt.

3. Übergeben Sie die EncodingProvider Instanz 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 die entsprechende 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 in der .NET Framework-Klassenbibliothek für .NET Core-Anwendungen verfügbar macht. Darüber hinaus können Sie von der EncodingProvider Klasse abgeleitet werden, um eigene Codierungen verfügbar zu machen.

Konstruktoren

Name	Beschreibung
EncodingProvider()	Initialisiert eine neue Instanz der EncodingProvider-Klasse.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
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(Int32)	Gibt die Codierung zurück, die dem angegebenen Codeseitenbezeichner zugeordnet ist.
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(String)	Gibt die Codierung mit dem angegebenen Namen zurück.
GetEncodings()	Gibt ein Array zurück, das alle Codierungen enthält, die von der EncodingProvider.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• GetEncoding(String)
• Instance