Console.OutputEncoding Propriété

Référence

Définition

Espace de noms:: System

Assembly:: System.Console.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit l'encodage que la console utilise pour écrire la sortie.

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

Valeur de propriété

Encoding

Encodage utilisé pour écrire la sortie de la console.

Attributs: UnsupportedOSPlatformAttribute

Exceptions

ArgumentNullException

La valeur de propriété dans une opération set est null.

IOException

Une erreur s’est produite lors de l’exécution de cette opération.

SecurityException

Votre application n’est pas autorisée à effectuer cette opération.

Remarques

La console utilise l’encodage de sortie pour traduire les caractères écrits par une application dans les caractères d’affichage de la console correspondants. La page de codes par défaut utilisée par la console est déterminée par les paramètres régionaux système.

à partir du .NET Framework 4, une opération d’extraction de propriété peut retourner une valeur mise en cache au lieu de l’encodage de sortie actuel de la console. cela peut se produire si la valeur de la OutputEncoding propriété est modifiée par d’autres moyens qu’une assignation à la OutputEncoding propriété, par exemple l’appel de la SetConsoleOutputCP fonction Windows.

Notes pour les appelants

parmi les encodages Unicode, la Console classe prend en charge l’encodage utf-8 avec la UTF8Encoding classe et, à partir de la .NET Framework 4,5, elle prend en charge l’encodage utf-16 avec la UnicodeEncoding classe. L’encodage UTF-32 avec la UTF32Encoding classe n’est pas pris en charge. Toute tentative de définition de l’encodage de sortie au format UTF-32 lève une exception IOException .

Notez que l’affichage correct des caractères Unicode dans la console nécessite les éléments suivants :

-La console doit utiliser une police TrueType, telle que Lucida Console ou consolas, pour afficher des caractères.

-Une police utilisée par la console doit définir le ou les glyphes particuliers à afficher. La console peut tirer parti de la liaison des polices pour afficher les glyphes des polices liées si la police de base ne contient pas de définition pour ce glyphe.

Pour plus d’informations sur la prise en charge de l’encodage Unicode par la console, consultez la section « prise en charge d’Unicode pour la console » dans la Console classe.

S’applique à