CultureInfo.GetCultureInfo Méthode

Définition

Récupère une instance mise en cache et en lecture seule d'une culture.

Surcharges

GetCultureInfo(String, Boolean)

Récupère une instance mise en cache et en lecture seule d'une culture.

GetCultureInfo(String, String)

Récupère une instance mise en cache et en lecture seule d'une culture. Les paramètres spécifient une culture qui est initialisée avec les objets TextInfo et CompareInfo spécifiés par une autre culture.

GetCultureInfo(Int32)

Récupère une instance mise en cache et en lecture seule d'une culture à l'aide de l'identificateur de culture spécifié.

GetCultureInfo(String)

Récupère l'instance mise en cache et en lecture seule d'une culture à l'aide du nom de culture spécifié.

GetCultureInfo(String, Boolean)

Récupère une instance mise en cache et en lecture seule d'une culture.

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

name
String

Nom d'une culture. Il ne respecte pas la casse.

predefinedOnly
Boolean

true en cas de demande de création d’une instance d’une culture connue de la plateforme. false s’il est acceptable de retreint une culture composée même si la plateforme ne transporte pas de données pour elle.

Retours

Une 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.

S’applique à

GetCultureInfo(String, String)

Récupère une instance mise en cache et en lecture seule d'une culture. Les paramètres spécifient une culture qui est initialisée avec les objets TextInfo et CompareInfo spécifiés par une autre culture.

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

name
String

Nom d'une culture. name ne respecte pas la casse.

altName
String

Nom d’une culture qui fournit les objets TextInfo et CompareInfo utilisés pour initialiser name. altName ne respecte pas la casse.

Retours

Objet CultureInfo en lecture seule.

Exceptions

name ou altName est null.

name ou altName spécifie une culture qui n’est pas pris en charge. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

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

S’applique à

GetCultureInfo(Int32)

Récupère une instance mise en cache et en lecture seule d'une culture à l'aide de l'identificateur de culture spécifié.

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

culture
Int32

Identificateur de paramètres régionaux (LCID).

Retours

Objet CultureInfo en lecture seule.

Exceptions

culture est inférieur à zéro.

culture spécifie une culture qui n’est pas prise en charge. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

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

S’applique à

GetCultureInfo(String)

Récupère l'instance mise en cache et en lecture seule d'une culture à l'aide du nom de culture spécifié.

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

name
String

Nom d'une culture. name ne respecte pas la casse.

Retours

Objet CultureInfo en lecture seule.

Exceptions

name a la valeur null.

name spécifie une culture qui n’est pas prise en charge. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.

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

S’applique à