Encoding.Default Eigenschaft

Definition

Namespace:
System.Text
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
Encoding.cs
Quelle:
Encoding.cs
Quelle:
Encoding.cs
Quelle:
Encoding.cs
Quelle:
Encoding.cs

Ruft die Standardcodierung für diese .NET-Implementierung ab.

public:
 static property System::Text::Encoding ^ Default { System::Text::Encoding ^ get(); };
public static System.Text.Encoding Default { get; }
static member Default : System.Text.Encoding
Public Shared ReadOnly Property Default As Encoding

Eigenschaftswert

Encoding

Die Standardcodierung für diese .NET-Implementierung.

Hinweise

Das Verhalten der Default Eigenschaft variiert zwischen verschiedenen .NET-Implementierungen:

  • In .NET Framework: Gibt die Codierung zurück, die der aktiven Codeseite des Systems entspricht. Dies ist die gleiche Codierung, die zurückgegeben GetEncoding(Int32) wird, wenn sie mit einem codepage Argument aufgerufen 0wird.

  • In .NET Core und höheren Versionen: Gibt immer ein UTF8Encoding Objekt zurück. Dieses Verhalten wurde geändert, um die Verwendung von Unicode-Codierungen für eine bessere plattformübergreifende Kompatibilität und Datenintegrität zu fördern.

Für die konsistentesten Ergebnisse auf verschiedenen Plattformen und .NET-Implementierungen sollten Sie eine bestimmte Unicode-Codierung wie UTF-8 direkt verwenden, anstatt sich auf die Standardcodierung zu verlassen. Sie können UTF-8-Codierung durch Aufrufen Encoding.UTF8 oder Encoding.GetEncoding(String) mit "utf-8" abrufen.

Warning

Verschiedene Computer können unterschiedliche Codierungen als Standard verwenden, und die Standardcodierung kann sich auf einem einzelnen Computer ändern. Wenn Sie die Encoding.Default Codierung zum Codieren und Decodieren von Daten verwenden, die zwischen Computern gestreamt oder zu unterschiedlichen Zeiten auf demselben Computer abgerufen wurden, werden diese Daten möglicherweise falsch übersetzt. Darüber hinaus verwendet die von der Default Eigenschaft zurückgegebene Codierung das Best-Fit-Fallback, um nicht unterstützte Zeichen zu Zeichen zuzuordnen, die von der Codeseite unterstützt werden. Aus diesen Gründen wird die Verwendung der Standardcodierung nicht empfohlen. Um sicherzustellen, dass codierte Bytes ordnungsgemäß decodiert werden, sollten Sie eine Unicode-Codierung verwenden, wie z. B. UTF8Encoding oder UnicodeEncoding. Sie können auch ein Protokoll auf höherer Ebene verwenden, um sicherzustellen, dass dasselbe Format für die Codierung und Decodierung verwendet wird.

Die Default Eigenschaft gibt immer die UTF8Encoding. UTF-8 wird auf allen Betriebssystemen (Windows, Linux und macOS) unterstützt, auf denen .NET Apps ausgeführt werden.

Gilt für: