Freigeben über

CodePagesEncodingProvider Klasse

Definition

Namespace:
System.Text
Assembly:
System.Text.Encoding.CodePages.dll
Paket:
System.Text.Encoding.CodePages v11.0.0-preview.2.26159.112
Quelle:
CodePagesEncodingProvider.cs
Quelle:
CodePagesEncodingProvider.cs
Quelle:
CodePagesEncodingProvider.cs
Quelle:
CodePagesEncodingProvider.cs
Quelle:
CodePagesEncodingProvider.cs
Quelle:
CodePagesEncodingProvider.cs

Bietet Zugriff auf einen Codierungsanbieter für Codeseiten, die andernfalls nur im Desktop .NET Framework verfügbar sind.

public ref class CodePagesEncodingProvider sealed
public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider
[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider
public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider
[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class
type CodePagesEncodingProvider = class
    inherit EncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider
Vererbung
Object
CodePagesEncodingProvider
Vererbung
Object
EncodingProvider
CodePagesEncodingProvider
Attribute
SecurityCriticalAttribute

Hinweise

Das .NET Framework für den Windows-Desktop unterstützt einen großen Satz von Unicode- und Codeseitencodierungen. .NET Core unterstützt dagegen 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 Encoding.Unicode Eigenschaft zurückgegeben wird.

  • UTF-16BE (Codepage 1201), das durch Aufrufen des UnicodeEncoding.UnicodeEncoding Oder UnicodeEncoding.UnicodeEncoding 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.

Abgesehen von Codepage 20127 werden Codeseitencodierungen nicht unterstützt.

Die CodePagesEncodingProvider Klasse wird erweitert EncodingProvider , um diese Codeseiten für .NET Core verfügbar zu machen. Um diese zusätzlichen Codeseiten zu verwenden, gehen Sie wie folgt vor:

Nachdem ein EncodingProvider Objekt registriert wurde, stehen die von ihr unterstützten Codierungen durch Aufrufen der Überladungen Encoding.GetEncodingzur Verfügung. Sie sollten die EncodingProvider.GetEncoding Überladungen nicht aufrufen.

Auswirkungen auf das Standardcodierungsverhalten

Die Registrierung CodePagesEncodingProvider wirkt sich auch auf das Verhalten des Aufrufs GetEncoding(Int32) mit einem codepage Argument in 0 .NET (Core) aus:

  • Gibt unter Windows die Codierung zurück, GetEncoding(0) die der aktiven Codeseite des Systems entspricht, die das gleiche Verhalten wie in .NET Framework aufweist.
  • Gibt auf Nicht-Windows-Plattformen GetEncoding(0) UTF-8 zurück, wobei die plattformübergreifende Konsistenz beibehalten wird.

Wenn kein Codierungsanbieter registriert ist, GetEncoding(0) wird UTF-8 auf allen Plattformen in .NET Core und höheren Versionen zurückgegeben.

Eigenschaften

Name Beschreibung
Instance

Ruft einen Codierungsanbieter für Codeseiten ab, die in .NET Framework, aber nicht in der aktuellen .NET Framework-Plattform unterstützt werden.

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.

(Geerbt von EncodingProvider)
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.

(Geerbt von EncodingProvider)
GetEncoding(String)

Gibt die Codierung zurück, die dem angegebenen Codeseitennamen zugeordnet ist.
GetEncodings()

Gibt ein Array zurück, das alle Codierungen enthält, die von der CodePagesEncodingProvider.
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)

Gilt für: