EncodingProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die Basisklasse für einen Codierungsanbieter bereit, der Codierungen bereitstellt, die auf einer bestimmten Plattform nicht verfügbar sind.
public ref class EncodingProvider abstractpublic abstract class EncodingProvider[System.Runtime.InteropServices.ComVisible(true)]
public abstract class EncodingProvidertype EncodingProvider = class[<System.Runtime.InteropServices.ComVisible(true)>]
type EncodingProvider = classPublic MustInherit Class EncodingProvider- Vererbung
-
EncodingProvider
- Abgeleitet
- Attribute
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
bigEndianWert vontrue.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
bigEndianParameter instanziiert wird und einen Werttrueim 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:
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.
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.
Ü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.
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) |
