Partager via

Console.OutputEncoding Propriété

Définition

Espace de noms:
System
Assemblys:
netstandard.dll, System.Console.dll
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
Console.cs
Source:
Console.cs
Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Obtient ou définit l’encodage utilisé par la console 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; [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

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 pendant 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 en caractères d’affichage de 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.

À compter de .NET Framework 4, une opération d’obtention 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 un moyen autre qu’une affectation à la OutputEncoding propriété, telle que l’appel de la fonction Windows SetConsoleOutputCP .

Notes pour les appelants

Parmi les encodages Unicode, la Console classe prend en charge l’encodage UTF-8 avec la UTF8Encoding classe et, à compter de .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. La tentative de définition de l’encodage de sortie sur UTF-32 lève un IOException.

Notez que l’affichage 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 glyphe ou les glyphes particuliers à afficher. La console peut tirer parti de la liaison de polices pour afficher des glyphes à partir de 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 Unicode pour la console » dans la Console classe.

S’applique à