Console.OutputEncoding Eigenschaft

Definition

Ruft die Codierung ab, die die Konsole verwendet, um die Ausgabe zu schreiben, 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; set; }
public static System.Text.Encoding OutputEncoding { get; [System.Runtime.Versioning.UnsupportedOSPlatform("android")] [System.Runtime.Versioning.UnsupportedOSPlatform("ios")] [System.Runtime.Versioning.UnsupportedOSPlatform("tvos")] set; }
static member OutputEncoding : System.Text.Encoding with 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
Public Shared Property OutputEncoding As Encoding

Eigenschaftswert

Die Codierung, die verwendet wird, um die Konsolenausgabe zu schreiben.

Attribute

Ausnahmen

Der Eigenschaftswert in einer Set-Operation ist null.

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

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

Hinweise

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

Ab dem .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 mit anderen Mitteln als einer Zuweisung an die OutputEncoding -Eigenschaft geändert wird, z. B. durch Aufrufen der Windows-Funktion SetConsoleOutputCP .

Hinweise für Aufrufer

Von den Unicode-Codierungen unterstützt die Klasse die Console UTF-8-Codierung mit der UTF8Encoding -Klasse und ab dem .NET Framework 4.5 die UTF-16-Codierung mit der UnicodeEncoding -Klasse. Die UTF-32-Codierung mit der UTF32Encoding -Klasse wird nicht unterstützt. Wenn Sie versuchen, die Ausgabecodierung auf UTF-32 festzulegen, wird ein IOExceptionausgelöst.

Beachten Sie, dass für die erfolgreiche Anzeige von Unicode-Zeichen in der Konsole Folgendes erforderlich ist:

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

  • Eine von der Konsole verwendete Schriftart muss die jeweiligen anzuzeigenden Glyphen oder Glyphen definieren. Die Konsole kann die Schriftartverknüpfung 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: