Console.OutputEncoding Console.OutputEncoding Console.OutputEncoding Console.OutputEncoding Property

Définition

Obtient ou définit l'encodage que la console utilise pour écrire la sortie.Gets or sets the encoding the console uses to write 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; }
member this.OutputEncoding : System.Text.Encoding with get, set
Public Shared Property OutputEncoding As Encoding

Valeur de propriété

Encodage utilisé pour écrire la sortie de la console.The encoding used to write console output.

Exceptions

La valeur de propriété dans une opération set est null.The property value in a set operation is null.

Une erreur s’est produite lors de l’exécution de cette opération.An error occurred during the execution of this operation.

Votre application n’est pas autorisée à effectuer cette opération.Your application does not have permission to perform this operation.

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.The console uses the output encoding to translate characters written by an application into corresponding console display characters. La page de codes par défaut utilisée par la console est déterminée par les paramètres régionaux système.The default code page that the console uses is determined by the system locale.

À compter de .NET Framework 4.NET Framework 4, une opération de récupération de propriété peut retourner une valeur mise en cache au lieu de l’encodage de sortie actuel de la console.Starting with the .NET Framework 4.NET Framework 4, a property get operation may return a cached value instead of the console's current output encoding. Cela peut se produire si la valeur de OutputEncoding la propriété est modifiée par d’autres moyens qu’une assignation à OutputEncoding la propriété, par exemple l’appel SetConsoleOutputCP de la fonction Windows.This can occur if the value of the OutputEncoding property is modified by some means other than an assignment to the OutputEncoding property, such as calling the Windows SetConsoleOutputCP function.

Notes pour les appelants

Parmi les encodages Unicode, la Console classe prend en charge l’encodage UTF UTF8Encoding -8 avec la classe .NET Framework 4.5.NET Framework 4.5et, à compter de, elle prend en charge UnicodeEncoding l’encodage UTF-16 avec la classe.Of the Unicode encodings, the Console class supports UTF-8 encoding with the UTF8Encoding class and, starting with the .NET Framework 4.5.NET Framework 4.5, it supports UTF-16 encoding with the UnicodeEncoding class. L’encodage UTF-32 UTF32Encoding avec la classe n’est pas pris en charge.UTF-32 encoding with the UTF32Encoding class is not supported. Toute tentative de définition de l’encodage de sortie au format UTF IOException-32 lève une exception.Attempting to set the output encoding to UTF-32 throws an IOException.

Notez que l’affichage correct des caractères Unicode dans la console nécessite les éléments suivants :Note that successfully displaying Unicode characters to the console requires the following: -La console doit utiliser une police TrueType, telle que Lucida Console ou consolas, pour afficher des caractères.- The console must use a TrueType font, such as Lucida Console or Consolas, to display characters.

-Une police utilisée par la console doit définir le ou les glyphes particuliers à afficher.- A font used by the console must define the particular glyph or glyphs to be displayed. 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.The console can take advantage of font linking to display glyphs from linked fonts if the base font does not contain a definition for that glyph.

Pour plus d’informations sur la prise en charge de l’encodage Unicode par la console, consultez la section « prise en Console charge d’Unicode pour la console » dans la classe.For more information about support for Unicode encoding by the console, see the "Unicode Support for the Console" section in the Console class.

Sécurité

UIPermission
pour la lecture et l’écriture dans les fenêtres de niveau supérieur et les sous-fenêtres.for reading and writing to top-level windows and subwindows. Énumération associée:SafeTopLevelWindowsAssociated enumeration: SafeTopLevelWindows

S’applique à