Console.OutputEncoding 屬性

定義

命名空間:

System

組件:

System.Console.dll

Source:

Console.cs

取得或設定主控台用來寫入輸出的編碼方式。

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; }

[<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

屬性值

Encoding

用來寫入主控台輸出的編碼方式。

屬性

UnsupportedOSPlatformAttribute

例外狀況

ArgumentNullException

設定作業中的屬性值為 null。

IOException

執行這項作業期間發生錯誤。

SecurityException

您的應用程式沒有執行這項作業的權限。

備註

主控台會使用輸出編碼，將應用程式寫入的字元轉譯成對應的主控台顯示字元。 主控台使用的預設字碼頁是由系統地區設定所決定。

從 .NET Framework 4 開始，屬性取得作業可能會傳回快取的值，而不是主控台目前的輸出編碼。 如果屬性的值 OutputEncoding 是由屬性指派 OutputEncoding 以外的一些方法修改，例如呼叫 Windows SetConsoleOutputCP 函式，就可能發生此情況。

給呼叫者的注意事項

在 Unicode 編碼中，類別 Console 支援使用 類別的 UTF-8 編碼 UTF8Encoding ，從 .NET Framework 4.5 開始，它支援使用 類別的 UnicodeEncoding UTF-16 編碼。 不支援使用 類別的 UTF32Encoding UTF-32 編碼。 嘗試將輸出編碼設定為 UTF-32 會擲回 IOException 。

請注意，成功向主控台顯示 Unicode 字元需要下列專案：

• 主控台必須使用 TrueType 字型，例如 Lucida Console 或 Consolas 來顯示字元。

• 主控台所使用的字型必須定義要顯示的特定圖像或圖像。 如果基底字不包含該字元的定義，主控台可以利用字型連結來顯示連結字型中的字元。

For more information about support for Unicode encoding by the console, see the "Unicode Support for the Console" section in the Console class.