Console.OutputEncoding Proprietà

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Console.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta la codifica usata dalla console per scrivere l'output.

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

member this.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")>]
member this.OutputEncoding : System.Text.Encoding with get, set

Public Shared Property OutputEncoding As Encoding

Valore della proprietà

Encoding

Codifica usata per scrivere l'output dalla console.

Attributi: UnsupportedOSPlatformAttribute

Eccezioni

ArgumentNullException

Il valore della proprietà in un'operazione set è null.

IOException

Si è verificato un errore durante l'esecuzione dell'operazione.

SecurityException

L'applicazione non ha l'autorizzazione per eseguire questa operazione.

Commenti

La console usa la codifica di output per convertire i caratteri scritti da un'applicazione in caratteri di visualizzazione della console corrispondenti. La tabella codici predefinita utilizzata dalla console è determinata dalle impostazioni locali del sistema.

A partire dalla .NET Framework 4, un'operazione get della proprietà può restituire un valore memorizzato nella cache anziché la codifica di output corrente della console. Questo problema può verificarsi se il valore della proprietà viene modificato in modo diverso da un'assegnazione alla proprietà, ad esempio chiamando la funzione Windows OutputEncoding OutputEncoding SetConsoleOutputCP funzione.

Note per i chiamanti

Tra le codifiche Unicode, la classe supporta la codifica UTF-8 con la classe e, a partire da Console .NET Framework 4.5, supporta la codifica UTF8Encoding UTF-16 con la UnicodeEncoding classe . La codifica UTF-32 con UTF32Encoding la classe non è supportata. Il tentativo di impostare la codifica di output su UTF-32 genera un'eccezione IOException .

Si noti che la corretta visualizzazione dei caratteri Unicode nella console richiede quanto segue:

La console deve usare un tipo di carattere TrueType, ad esempio Lucida Console o Consolas, per visualizzare i caratteri.
Un tipo di carattere usato dalla console deve definire il glifo o i glifi specifici da visualizzare. La console può sfruttare il collegamento del tipo di carattere per visualizzare i glifi dei tipi di carattere collegati se il tipo di carattere di base non contiene una definizione per tale glifo.

Per altre informazioni sul supporto della codifica Unicode da parte della console, vedere la sezione "Supporto Unicode per la console" nella Console classe .

Si applica a