CultureInfo.GetCultureInfo Méthode

Source:

CultureInfo.cs

Source:

CultureInfo.cs

Source:

CultureInfo.cs

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);

public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);

static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

Paramètres

Retours

Instance en lecture seule d’une culture.

Remarques

Par défaut, lorsque vous essayez de créer une culture et que la plateforme sous-jacente (Windows NLS ou ICU) ne contient pas de données spécifiques pour cette culture, la plateforme tente de construire une culture avec des données provenant d’autres cultures ou de valeurs constantes.

Définir predefinedOnly sur true garantit qu’une culture est créée uniquement si la plateforme a des données réelles pour cette culture.

Source:

CultureInfo.cs

Source:

CultureInfo.cs

Source:

CultureInfo.cs

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);

public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);

static member GetCultureInfo : string * string -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

Paramètres

Retours

Objet CultureInfo en lecture seule.

Exceptions

Remarques

Pour obtenir la liste des noms de culture prédéfinis sur les systèmes Windows, consultez la colonne Balise de langue dans la liste des noms de langue/région pris en charge par Windows. Les noms de culture respectent la norme définie par BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

La GetCultureInfo méthode obtient un objet mis en cache en lecture seule CultureInfo . Il offre de meilleures performances qu’un appel correspondant à un CultureInfo constructeur. La méthode est utilisée pour créer une culture similaire à celle spécifiée par le name paramètre, mais avec des règles de tri et de casse différentes.

Si name ou altName est le nom de la culture actuelle, les objets retournés ne reflètent aucun remplacement utilisateur. Si name a la valeur String.Empty, la méthode retourne la culture invariante. Cela équivaut à récupérer la valeur de la InvariantCulture propriété . Si altName a la valeur String.Empty, la méthode utilise le système d’écriture et les règles de comparaison spécifiés par la culture invariante.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si name ou altName non un nom de culture valide. À compter de .NET Framework 4, cette méthode lève un CultureNotFoundException. À compter des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient name du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture et si name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une CultureNotFoundException exception.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• Name
• ClearCachedData()

Source:

CultureInfo.cs

Source:

CultureInfo.cs

Source:

CultureInfo.cs

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);

public static System.Globalization.CultureInfo GetCultureInfo (int culture);

static member GetCultureInfo : int -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

Paramètres

Retours

Objet CultureInfo en lecture seule.

Exceptions

Remarques

Nous vous recommandons d’utiliser la surcharge de chaîne de cette méthode (GetCultureInfo(String)), car les noms de paramètres régionaux doivent être utilisés à la place des LCID. Pour les paramètres régionaux personnalisés, le nom des paramètres régionaux est requis.

Si culture est l’identificateur de paramètres régionaux de la culture actuelle, l’objet retourné CultureInfo ne reflète aucun remplacement utilisateur.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si culture n’est pas un identificateur de culture valide. À compter de .NET Framework 4, cette méthode lève un CultureNotFoundException. À partir des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient culture du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture, la méthode lève un CultureNotFoundException.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• LCID
• ClearCachedData()

Source:

CultureInfo.cs

Source:

CultureInfo.cs

Source:

CultureInfo.cs

public:
 static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);

public static System.Globalization.CultureInfo GetCultureInfo (string name);

static member GetCultureInfo : string -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfo (name As String) As CultureInfo

Paramètres

Retours

Objet CultureInfo en lecture seule.

Exceptions

Remarques

Pour obtenir la liste des noms de culture prédéfinis sur les systèmes Windows, consultez la colonne Balise de langue dans la liste des noms de langue/région pris en charge par Windows. Les noms de culture respectent la norme définie par BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langue BCP-47 valide.

La GetCultureInfo méthode récupère un objet mis en cache en lecture seule CultureInfo . Il offre de meilleures performances qu’un appel correspondant au CultureInfo.CultureInfo(String) constructeur.

Si name est le nom de la culture actuelle, l’objet retourné CultureInfo ne reflète aucun remplacement utilisateur. Cela rend la méthode appropriée pour les applications serveur ou les outils qui n’ont pas de compte d’utilisateur réel sur le système et qui doivent charger efficacement plusieurs cultures.

Si name a la valeur String.Empty, la méthode retourne la culture invariante. Cela équivaut à récupérer la valeur de la InvariantCulture propriété .

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException si name n’est pas un nom de culture valide. À compter de .NET Framework 4, cette méthode lève un CultureNotFoundException. À partir des applications qui s’exécutent sous .NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un CultureInfo objet dont l’identificateur provient name du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture et si name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève un CultureNotFoundException.

Sur .NET 6 et versions ultérieures, une CultureNotFoundException exception est levée si l’application s’exécute dans un environnement où le mode d’invariant de globalisation est activé, par exemple, certains conteneurs Docker et une culture autre que la culture invariante est spécifiée.

Voir aussi

• Name