CultureInfo Constructors

Definitie

Initialiseert een nieuw exemplaar van de CultureInfo klasse.

Overloads

Name Description
CultureInfo(Int32)

Initialiseert een nieuw exemplaar van de CultureInfo klasse op basis van de cultuur die is opgegeven door de cultuur-id.

CultureInfo(String)

Initialiseert een nieuw exemplaar van de CultureInfo klasse op basis van de cultuur die op naam is opgegeven.

CultureInfo(Int32, Boolean)

Initialiseert een nieuw exemplaar van de klasse CultureInfo op basis van de cultuur die is opgegeven door de cultuur-id en op een waarde die aangeeft of de door de gebruiker geselecteerde cultuurinstellingen uit Windows moeten worden gebruikt.

CultureInfo(String, Boolean)

Initialiseert een nieuw exemplaar van de klasse CultureInfo op basis van de cultuur die is opgegeven op naam en op een waarde die aangeeft of de door de gebruiker geselecteerde cultuurinstellingen uit Windows moeten worden gebruikt.

CultureInfo(Int32)

Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs

Initialiseert een nieuw exemplaar van de CultureInfo klasse op basis van de cultuur die is opgegeven door de cultuur-id.

public:
 CultureInfo(int culture);
public CultureInfo(int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)

Parameters

culture
Int32

Een vooraf gedefinieerde CultureInfo-id, LCID eigenschap van een bestaand CultureInfo-object of Windows-only cultuur-id.

Uitzonderingen

culture is kleiner dan nul.

culture is geen geldige cultuur-id. Zie de sectie Notities voor bellers voor meer informatie.

Opmerkingen

Vooraf gedefinieerde cultuur-id's voor culturen die beschikbaar zijn op Windows systeem, worden vermeld in de kolom Language in de kolom lijst met taal-/regionamen die worden ondersteund door Windows. Cultuurnamen volgen de standaard die is gedefinieerd door BCP 47.

In de meeste gevallen wordt de culture parameter toegewezen aan de bijbehorende NLS-landinstellings-id (National Language Support). De waarde van de culture parameter wordt de waarde van de LCID eigenschap van de nieuwe CultureInfo.

U wordt aangeraden de constructor CultureInfo.CultureInfovoor landinstellingen aan te roepen, omdat landinstellingen de voorkeur geven aan LCID's. Voor aangepaste landinstellingen is een landinstellingsnaam vereist.

De gebruiker kan ervoor kiezen om bepaalde waarden te overschrijven die zijn gekoppeld aan de huidige cultuur van Windows via het gedeelte landinstellingen en taalopties van Configuratiescherm. De gebruiker kan er bijvoorbeeld voor kiezen om de datum in een andere notatie weer te geven of een andere valuta te gebruiken dan de standaardwaarde voor de cultuur. Als de opgegeven cultuur-id overeenkomt met de cultuur-id van de huidige Windows cultuur, deze constructor maakt een CultureInfo die deze onderdrukkingen gebruikt, inclusief gebruikersinstellingen voor de eigenschappen van de DateTimeFormatInfo-instantie die wordt geretourneerd door de eigenschap DateTimeFormat, en de eigenschappen van de NumberFormatInfo-instantie die wordt geretourneerd door de eigenschap NumberFormat. Als de gebruikersinstellingen niet compatibel zijn met de cultuur die is gekoppeld aan de CultureInfo (bijvoorbeeld als de geselecteerde agenda niet een van de OptionalCalendars) is, worden de resultaten van de methoden en de waarden van de eigenschappen niet gedefinieerd.

Als de opgegeven cultuur-id niet overeenkomt met de id van de huidige Windows cultuur, maakt deze constructor een CultureInfo die gebruikmaakt van de standaardwaarden voor de opgegeven cultuur.

De UseUserOverride eigenschap is altijd ingesteld op true.

Stel dat Arabisch (Saoedi-Arabië) de huidige Windows cultuur is en dat de gebruiker de kalender heeft gewijzigd van Hijri in Gregoriaanse taal.

Voor culturen die de euro gebruiken, stelt .NET Framework en Windows XP de standaardvaluta in als euro. Oudere versies van Windows echter niet. Als de gebruiker van een oudere versie van Windows de valuta-instelling daarom niet heeft gewijzigd via het gedeelte landinstellingen en taalopties van Configuratiescherm, is de valuta mogelijk onjuist. Als u de standaardinstelling van het .NET Framework voor de valuta wilt gebruiken, moet de toepassing een CultureInfo constructoroverbelasting gebruiken die een parameter useUserOverride accepteert en deze instelt op false.

Note

Voor compatibiliteit met eerdere versies heeft een cultuur die is samengesteld met behulp van een culture parameter van 0x0004 of 0x7c04 respectievelijk een Name eigenschap van zh-CHS of zh-CHT, respectievelijk. U moet in plaats daarvan liever de cultuur maken met behulp van de huidige standaardcultuurnamen van zh-Hans of zh-Hant, tenzij u een reden hebt om de oudere namen te gebruiken.

Note

LCID's worden afgeschaft en implementeerfuncties worden sterk aangeraden nieuwere versies van API's te gebruiken die in plaats daarvan BCP 47-landinstellingen ondersteunen. Elke LCID kan worden vertegenwoordigd door een BCP 47 landinstellingsnaam, maar het omgekeerde is niet waar. Het LCID-bereik is beperkt en kan niet alle mogelijke combinaties van taal en regio uniek identificeren.

Notities voor bellers

.NET Framework 3.5 en eerdere versies genereert een ArgumentException als culture geen geldige cultuur-id is. Vanaf .NET Framework 4 genereert deze constructor een CultureNotFoundException. Vanaf apps die worden uitgevoerd onder .NET Framework 4 of hoger op Windows 7 of hoger, probeert de methode een CultureInfo-object op te halen waarvan de id culture van het besturingssysteem is. Als het besturingssysteem die cultuur niet ondersteunt, genereert de methode een CultureNotFoundException uitzondering.

In .NET 6 en latere versies wordt een CultureNotFoundException gegenereerd als de app wordt uitgevoerd in een omgeving waarin de globalization-invariant-modus is ingeschakeld, bijvoorbeeld sommige Docker-containers en een andere cultuur dan de invariante cultuur is opgegeven.

Zie ook

Van toepassing op

CultureInfo(String)

Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs

Initialiseert een nieuw exemplaar van de CultureInfo klasse op basis van de cultuur die op naam is opgegeven.

public:
 CultureInfo(System::String ^ name);
public CultureInfo(string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)

Parameters

name
String

Een vooraf gedefinieerde CultureInfonaam, Name van een bestaande CultureInfo of Windows-only cultuurnaam. name is niet hoofdlettergevoelig.

Uitzonderingen

name is nul.

name is geen geldige cultuurnaam. Zie de sectie Notities voor bellers voor meer informatie.

Voorbeelden

In het volgende voorbeeld wordt de huidige cultuur opgehaald. Als het iets anders is dan de Franse cultuur (Frankrijk), roept het de CultureInfo(String) constructor aan om een CultureInfo object te instantiëren dat de Franse cultuur (Frankrijk) vertegenwoordigt en het de huidige cultuur maakt. Anders maakt het een exemplaar van een CultureInfo object dat de Franse (Luxemburgse) cultuur vertegenwoordigt en het de huidige cultuur maakt.

using System;
using System.Globalization;

public class ChangeEx1
{
    public static void Main()
    {
        CultureInfo current = CultureInfo.CurrentCulture;
        Console.WriteLine("The current culture is {0}", current.Name);
        CultureInfo newCulture;
        if (current.Name.Equals("fr-FR"))
            newCulture = new CultureInfo("fr-LU");
        else
            newCulture = new CultureInfo("fr-FR");

        CultureInfo.CurrentCulture = newCulture;
        Console.WriteLine("The current culture is now {0}",
                          CultureInfo.CurrentCulture.Name);
    }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else
         newCulture = new CultureInfo("fr-FR")
      End If

      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}",
                        CultureInfo.CurrentCulture.Name)
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

Opmerkingen

Zie de kolom Language tag in de lijst met taal-/regionamen die worden ondersteund door Windows voor een lijst met vooraf gedefinieerde cultuurnamen op Windows systemen. Cultuurnamen volgen de standaard die is gedefinieerd door BCP 47. Bovendien kan name elke geldige BCP-47-taaltag zijn, te beginnen met Windows 10.

Als name dat het geval is String.Empty, maakt de constructor een exemplaar van de invariante cultuur. Dit komt overeen met het ophalen van de waarde van de InvariantCulture eigenschap.

De gebruiker kan ervoor kiezen om bepaalde waarden te overschrijven die zijn gekoppeld aan de huidige cultuur van Windows via het gedeelte landinstellingen en taalopties van Configuratiescherm. De gebruiker kan er bijvoorbeeld voor kiezen om de datum in een andere notatie weer te geven of een andere valuta te gebruiken dan de standaardwaarde voor de cultuur. Als de cultuur-id die is gekoppeld aan name overeenkomt met de cultuur-id van de huidige Windows cultuur, deze constructor maakt een CultureInfo-object dat gebruikmaakt van deze onderdrukkingen, inclusief gebruikersinstellingen voor de eigenschappen van de DateTimeFormatInfo-instantie die wordt geretourneerd door de eigenschap DateTimeFormat en de eigenschappen van de NumberFormatInfo-instantie die wordt geretourneerd door de eigenschap NumberFormat. Als de gebruikersinstellingen niet compatibel zijn met de cultuur die is geassocieerd met de CultureInfo, bijvoorbeeld als de geselecteerde kalender niet een van de OptionalCalendars is, dan zijn de resultaten van de methoden en de waarden van de eigenschappen niet gedefinieerd.

Als de cultuur-id die is gekoppeld aan name niet overeenkomt met de cultuur-id van de huidige Windows cultuur, maakt deze constructor een CultureInfo-object dat gebruikmaakt van de standaardwaarden voor de opgegeven cultuur.

De UseUserOverride eigenschap is altijd ingesteld op true.

Stel dat Arabisch (Saoedi-Arabië) de huidige cultuur van Windows is en dat de gebruiker de kalender van Hijri heeft gewijzigd in Gregoriaanse:

De LCID eigenschap van het nieuwe CultureInfo is ingesteld op de cultuur-id die is gekoppeld aan de opgegeven naam.

Notities voor bellers

.NET Framework 3.5 en eerdere versies genereert een ArgumentException als name geen geldige cultuurnaam is. Vanaf .NET Framework 4 genereert deze constructor een CultureNotFoundException. Vanaf apps die worden uitgevoerd onder .NET Framework 4 of hoger op Windows 7 of hoger, probeert de methode een CultureInfo-object op te halen waarvan de id name van het besturingssysteem is; als het besturingssysteem die cultuur niet ondersteunt en als name niet de naam is van een aanvullende of vervangingscultuur, de methode genereert een CultureNotFoundException uitzondering.

In .NET 6 en latere versies wordt een CultureNotFoundException gegenereerd als de app wordt uitgevoerd in een omgeving waarin de globalization-invariant-modus is ingeschakeld, bijvoorbeeld sommige Docker-containers en een andere cultuur dan de invariante cultuur is opgegeven.

Zie ook

Van toepassing op

CultureInfo(Int32, Boolean)

Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs

Initialiseert een nieuw exemplaar van de klasse CultureInfo op basis van de cultuur die is opgegeven door de cultuur-id en op een waarde die aangeeft of de door de gebruiker geselecteerde cultuurinstellingen uit Windows moeten worden gebruikt.

public:
 CultureInfo(int culture, bool useUserOverride);
public CultureInfo(int culture, bool useUserOverride);
new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo
Public Sub New (culture As Integer, useUserOverride As Boolean)

Parameters

culture
Int32

Een vooraf gedefinieerde CultureInfo-id, LCID eigenschap van een bestaand CultureInfo-object of Windows-only cultuur-id.

useUserOverride
Boolean

true om de door de gebruiker geselecteerde cultuurinstellingen te gebruiken (alleen Windows); false om de standaardcultuurinstellingen te gebruiken.

Uitzonderingen

culture is kleiner dan nul.

culture is geen geldige cultuur-id. Zie de sectie Notities voor bellers voor meer informatie.

Opmerkingen

Vooraf gedefinieerde cultuur-id's die beschikbaar zijn op Windows systemen, worden vermeld in de kolom Language in de lijst met taal-/regionamen die worden ondersteund door Windows. Cultuurnamen volgen de standaard die is gedefinieerd door BCP 47.

In de meeste gevallen wordt de culture parameter toegewezen aan de bijbehorende NLS-landinstellings-id (National Language Support). De waarde van de culture parameter wordt de waarde van de LCID eigenschap van de nieuwe CultureInfo.

U wordt aangeraden de constructor CultureInfo.CultureInfovoor landinstellingen aan te roepen, omdat landinstellingen de voorkeur geven aan LCID's. Voor aangepaste landinstellingen is een landinstellingsnaam vereist.

De gebruiker kan ervoor kiezen om bepaalde waarden te overschrijven die zijn gekoppeld aan de huidige cultuur van Windows via het gedeelte landinstellingen en taalopties van Configuratiescherm. De gebruiker kan er bijvoorbeeld voor kiezen om de datum in een andere notatie weer te geven of een andere valuta te gebruiken dan de standaardwaarde voor de cultuur.

Toepassingen mogen doorgaans geen onderdrukkingen van gebruikers toestaan. Het ongedaan maken van onderdrukkingen garandeert zelf geen stabiliteit van gegevens. Zie voor meer informatie het blogbericht Cultuurgegevens niet als stabiel worden beschouwd (met uitzondering van Invariant).

Als de eigenschap UseUserOverride is ingesteld op true en de opgegeven cultuur-id overeenkomt met de id van de huidige Windows cultuur, deze constructor maakt een CultureInfo die deze onderdrukkingen gebruikt, inclusief gebruikersinstellingen voor de eigenschappen van de DateTimeFormatInfo-instantie die wordt geretourneerd door de eigenschap DateTimeFormat, en de eigenschappen van de NumberFormatInfo-instantie geretourneerd door de eigenschap NumberFormat. Als de gebruikersinstellingen niet compatibel zijn met de cultuur die is geassocieerd met de CultureInfo, bijvoorbeeld als de geselecteerde kalender niet een van de OptionalCalendars is, dan zijn de resultaten van de methoden en de waarden van de eigenschappen niet gedefinieerd.

Anders maakt deze constructor een CultureInfo die gebruikmaakt van de standaardwaarden voor de opgegeven cultuur.

De waarde van de useUserOverride parameter wordt de waarde van de UseUserOverride eigenschap.

Stel dat Arabisch (Saoedi-Arabië) de huidige cultuur van Windows is en de gebruiker de kalender van Hijri heeft gewijzigd in Gregoriaanse kalender.

Voor culturen die de euro gebruiken, stelt het .NET Framework en Windows XP de standaardvaluta in als euro. Oudere versies van Windows echter niet. Als de gebruiker van een oudere versie van Windows de valuta-instelling daarom niet heeft gewijzigd via het gedeelte landinstellingen en taalopties van Configuratiescherm, is de valuta mogelijk onjuist. Als u de standaardinstelling van het .NET Framework voor de valuta wilt gebruiken, moet de toepassing de parameter useUserOverride instellen op false.

Note

Voor compatibiliteit met eerdere versies heeft een cultuur die is opgebouwd met behulp van een culture parameter van 0x0004 of 0x7c04 respectievelijk een Name eigenschap van zh-CHS of zh-CHT. U moet in plaats daarvan liever de cultuur maken met behulp van de huidige standaardcultuurnamen van zh-Hans of zh-Hant, tenzij u een reden hebt om de oudere namen te gebruiken.

Note

LCID's worden afgeschaft en implementeerfuncties worden sterk aangeraden nieuwere versies van API's te gebruiken die in plaats daarvan BCP 47-landinstellingen ondersteunen. Elke LCID kan worden vertegenwoordigd door een BCP 47 landinstellingsnaam, maar het omgekeerde is niet waar. Het LCID-bereik is beperkt en kan niet alle mogelijke combinaties van taal en regio uniek identificeren.

Notities voor bellers

.NET Framework 3.5 en eerdere versies genereert een ArgumentException als culture geen geldige cultuur-id is. Vanaf .NET Framework 4 genereert deze constructor een CultureNotFoundException. Vanaf apps die worden uitgevoerd onder .NET Framework 4 of hoger op Windows 7 of hoger, probeert de methode een CultureInfo-object op te halen waarvan de id culture van het besturingssysteem is. Als het besturingssysteem die cultuur niet ondersteunt, genereert de methode een CultureNotFoundException uitzondering.

In .NET 6 en latere versies wordt een CultureNotFoundException gegenereerd als de app wordt uitgevoerd in een omgeving waarin de globalization-invariant-modus is ingeschakeld, bijvoorbeeld sommige Docker-containers en een andere cultuur dan de invariante cultuur is opgegeven.

Zie ook

Van toepassing op

CultureInfo(String, Boolean)

Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs
Bron:
CultureInfo.cs

Initialiseert een nieuw exemplaar van de klasse CultureInfo op basis van de cultuur die is opgegeven op naam en op een waarde die aangeeft of de door de gebruiker geselecteerde cultuurinstellingen uit Windows moeten worden gebruikt.

public:
 CultureInfo(System::String ^ name, bool useUserOverride);
public CultureInfo(string name, bool useUserOverride);
new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo
Public Sub New (name As String, useUserOverride As Boolean)

Parameters

name
String

Een vooraf gedefinieerde CultureInfonaam, Name van een bestaande CultureInfo of Windows-only cultuurnaam. name is niet hoofdlettergevoelig.

useUserOverride
Boolean

true om de door de gebruiker geselecteerde cultuurinstellingen te gebruiken (alleen Windows); false om de standaardcultuurinstellingen te gebruiken.

Uitzonderingen

name is nul.

name is geen geldige cultuurnaam. Zie de sectie Notities voor bellers voor meer informatie.

Opmerkingen

Zie de kolom Language tag in de lijst met taal-/regionamen die worden ondersteund door Windows voor een lijst met vooraf gedefinieerde cultuurnamen. Cultuurnamen volgen de standaard die is gedefinieerd door BCP 47. Bovendien kan name elke geldige BCP-47-taaltag zijn, te beginnen met Windows 10.

Als name dat het geval is String.Empty, maakt de constructor een exemplaar van de invariante cultuur. Dit komt overeen met het ophalen van de waarde van de InvariantCulture eigenschap.

De gebruiker kan ervoor kiezen om een aantal waarden te overschrijven die zijn gekoppeld aan de huidige Windows cultuur via het gedeelte met land- en taalopties van Configuratiescherm. De gebruiker kan er bijvoorbeeld voor kiezen om de datum in een andere notatie weer te geven of een andere valuta te gebruiken dan de standaardwaarde voor de cultuur.

Toepassingen mogen doorgaans geen onderdrukkingen van gebruikers toestaan. Het ongedaan maken van onderdrukkingen garandeert zelf geen stabiliteit van gegevens. Zie voor meer informatie het blogbericht Cultuurgegevens niet als stabiel worden beschouwd (met uitzondering van Invariant).

Als de eigenschap UseUserOverride is ingesteld op true en de cultuur-id die is gekoppeld aan de opgegeven cultuurnaam, komt overeen met de cultuur-id van de huidige Windows cultuur, deze constructor maakt een CultureInfo die deze onderdrukkingen gebruikt, inclusief gebruikersinstellingen voor de eigenschappen van de DateTimeFormatInfo-instantie die wordt geretourneerd door de eigenschap DateTimeFormat, en de eigenschappen van de NumberFormatInfo-instantie die wordt geretourneerd door de eigenschap NumberFormat. Als de gebruikersinstellingen niet compatibel zijn met de cultuur die is geassocieerd met de CultureInfo, bijvoorbeeld als de geselecteerde kalender niet een van de OptionalCalendars is, dan zijn de resultaten van de methoden en de waarden van de eigenschappen niet gedefinieerd.

Anders maakt deze constructor een CultureInfo die gebruikmaakt van de standaardwaarden voor de opgegeven cultuur.

De waarde van de useUserOverride parameter wordt de waarde van de UseUserOverride eigenschap.

Stel dat Arabisch (Saoedi-Arabië) de huidige cultuur van Windows is en dat de gebruiker de kalender van Hijri heeft gewijzigd in Gregoriaanse kalender.

De LCID eigenschap van het nieuwe CultureInfo is ingesteld op de cultuur-id die is gekoppeld aan de opgegeven naam.

Voor culturen die de euro gebruiken, stelt het .NET Framework en Windows XP de standaardvaluta in als euro. Oudere versies van Windows doen dit echter niet. Als de gebruiker van een oudere versie van Windows de valuta-instelling daarom niet heeft gewijzigd via het gedeelte landinstellingen en taalopties van Configuratiescherm, is de valuta mogelijk onjuist. Als u de standaardinstelling van het .NET Framework voor de valuta wilt gebruiken, moet de toepassing de parameter useUserOverride instellen op false.

Notities voor bellers

.NET Framework 3.5 en eerdere versies genereert een ArgumentException als name geen geldige cultuurnaam is. Vanaf .NET Framework 4 genereert deze constructor een CultureNotFoundException. Vanaf apps die worden uitgevoerd onder .NET Framework 4 of hoger op Windows 7 of hoger, probeert de methode een CultureInfo-object op te halen waarvan de id name van het besturingssysteem is; als het besturingssysteem die cultuur niet ondersteunt en als name niet de naam is van een aanvullende of vervangingscultuur, de methode genereert een CultureNotFoundException uitzondering.

In .NET 6 en latere versies wordt een CultureNotFoundException gegenereerd als de app wordt uitgevoerd in een omgeving waarin de globalization-invariant-modus is ingeschakeld, bijvoorbeeld sommige Docker-containers en een andere cultuur dan de invariante cultuur is opgegeven.

Zie ook

Van toepassing op