Condividi tramite

Console.OutputEncoding Proprietà

Definizione

Spazio dei nomi:
System
Assembly:
netstandard.dll, System.Console.dll
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
Console.cs
Origine:
Console.cs
Origine:
Console.cs
Origine:
Console.cs
Origine:
Console.cs

Ottiene o imposta la codifica utilizzata 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; [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

Valore della proprietà

Encoding

Codifica utilizzata per scrivere l'output della console.

Attributi
UnsupportedOSPlatformAttribute

Eccezioni

ArgumentNullException

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

IOException

Si è verificato un errore durante l'esecuzione di questa operazione.

SecurityException

L'applicazione non dispone dell'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 usata dalla console è determinata dalle impostazioni locali di sistema.

A partire da .NET Framework 4, un'operazione get di proprietà può restituire un valore memorizzato nella cache anziché la codifica di output corrente della console. Ciò può verificarsi se il valore della OutputEncoding proprietà viene modificato da alcuni mezzi diversi da un'assegnazione alla OutputEncoding proprietà, ad esempio la chiamata alla funzione Windows SetConsoleOutputCP .

Note per i chiamanti

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

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

  • La console deve utilizzare un tipo di carattere TrueType, ad esempio Lucida Console o Consolas, per visualizzare i caratteri.

  • Un tipo di carattere utilizzato dalla console deve definire il glifo o i glifi specifici da visualizzare. La console può sfruttare i vantaggi del collegamento dei tipi di carattere per visualizzare glifi dai tipi di carattere collegati se il tipo di carattere di base non contiene una definizione per tale glifo.

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

Si applica a