Freigeben über

Console.OutputEncoding Eigenschaft

Definition

Namespace:
System
Assemblys:
netstandard.dll, System.Console.dll
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Ruft die Codierung ab, die die Konsole zum Schreiben der Ausgabe verwendet, oder legt diese fest.

public:
 static property System::Text::Encoding ^ OutputEncoding { System::Text::Encoding ^ get(); void set(System::Text::Encoding ^ value); };
public static System.Text.Encoding OutputEncoding { get; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
public static System.Text.Encoding OutputEncoding { get; set; }
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<set: System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member OutputEncoding : System.Text.Encoding with get, set
static member OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding

Eigenschaftswert

Encoding

Die zum Schreiben der Konsolenausgabe verwendete Codierung.

Attribute
UnsupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

Der Eigenschaftswert in einem Set-Vorgang lautet null.

IOException

Während der Ausführung dieses Vorgangs ist ein Fehler aufgetreten.

SecurityException

Ihre Anwendung verfügt nicht über die Berechtigung zum Ausführen dieses Vorgangs.

Hinweise

Die Konsole verwendet die Ausgabecodierung, um Zeichen, die von einer Anwendung geschrieben wurden, in entsprechende Konsolenanzeigezeichen zu übersetzen. Die von der Konsole verwendete Standardcodeseite wird durch das Systemgebietsschema bestimmt.

Ab .NET Framework 4 gibt ein Eigenschafts-Get-Vorgang möglicherweise einen zwischengespeicherten Wert anstelle der aktuellen Ausgabecodierung der Konsole zurück. Dies kann auftreten, wenn der Wert der OutputEncoding Eigenschaft durch eine andere Möglichkeit als eine Zuordnung zu der OutputEncoding Eigenschaft geändert wird, z. B. das Aufrufen der Windows-Funktion SetConsoleOutputCP .

Hinweise für Aufrufer

Von den Unicode-Codierungen unterstützt die Console Klasse UTF-8-Codierung mit der UTF8Encoding Klasse, und ab .NET Framework 4.5 unterstützt sie UTF-16-Codierung mit der UnicodeEncoding Klasse. UTF-32-Codierung mit der UTF32Encoding Klasse wird nicht unterstützt. Beim Versuch, die Ausgabecodierung auf UTF-32 festzulegen, wird ein IOException.

Beachten Sie, dass das erfolgreiche Anzeigen von Unicode-Zeichen in der Konsole Folgendes erfordert:

  • Die Konsole muss eine TrueType-Schriftart verwenden, z. B. Lucida Console oder Consolas, um Zeichen anzuzeigen.

  • Eine schriftart, die von der Konsole verwendet wird, muss die bestimmte Glyphe oder Glyphen definieren, die angezeigt werden sollen. Die Konsole kann die Verknüpfung von Schriftarten nutzen, um Glyphen aus verknüpften Schriftarten anzuzeigen, wenn die Basisschriftart keine Definition für diese Glyphe enthält.

Weitere Informationen zur Unterstützung der Unicode-Codierung durch die Konsole finden Sie im Abschnitt "Unicode-Unterstützung für die Konsole" in der Console Klasse.

Gilt für: