Console.OutputEncoding Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de codering op die door de console wordt gebruikt voor het schrijven van uitvoer.
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
Waarde van eigenschap
De codering die wordt gebruikt voor het schrijven van console-uitvoer.
- Kenmerken
Uitzonderingen
De eigenschapswaarde in een setbewerking is null.
Er is een fout opgetreden tijdens de uitvoering van deze bewerking.
Uw toepassing is niet gemachtigd om deze bewerking uit te voeren.
Opmerkingen
De console gebruikt de uitvoercodering om tekens te vertalen die zijn geschreven door een toepassing in overeenkomende consoleweergavetekens. De standaardcodepagina die door de console wordt gebruikt, wordt bepaald door de landinstelling van het systeem.
Vanaf het .NET Framework 4 kan een get-bewerking van een eigenschap een waarde in de cache retourneren in plaats van de huidige uitvoercodering van de console. Dit kan gebeuren als de waarde van de eigenschap OutputEncoding op een andere wijze wordt gewijzigd dan een toewijzing aan de eigenschap OutputEncoding, zoals het aanroepen van de functie Windows SetConsoleOutputCP.
Notities voor bellers
Van de Unicode-coderingen ondersteunt de klasse Console UTF-8-codering met de klasse UTF8Encoding en, te beginnen met de klasse .NET Framework 4.5, UTF-16-codering met de klasse UnicodeEncoding. UTF-32-codering met de UTF32Encoding klasse wordt niet ondersteund. Als u de uitvoercodering probeert in te stellen op UTF-32, wordt een IOException.
Houd er rekening mee dat het weergeven van Unicode-tekens aan de console het volgende vereist:
De console moet een TrueType-lettertype gebruiken, zoals Lucida Console of Consolas, om tekens weer te geven.
Een lettertype dat door de console wordt gebruikt, moet de specifieke symbool- of symbooltekens definiƫren die moeten worden weergegeven. De console kan profiteren van lettertypekoppelingen om glyphs van gekoppelde lettertypen weer te geven als het basislettertype geen definitie voor die glyph bevat.
Zie de sectie Console Unicode-ondersteuning voor de console voor meer informatie over ondersteuning voor Unicode-codering door de console.