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 possible de récupérer une culture créée même si la plateforme ne contient pas de données pour celle-ci.

Retours

CultureInfo

Instance en lecture seule d’une culture.

Remarques

par défaut, lorsque vous tentez de créer une culture et 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 les données d’autres cultures ou certaines valeurs constantes.

predefinedOnlyLa définition de la valeur permet de true garantir qu’une culture est créée uniquement si la plateforme contient 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

CultureInfo

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 cultures prédéfinis sur les systèmes Windows, consultez la colonne tag language 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, à partir de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.

La GetCultureInfo méthode obtient un objet mis en cache et en lecture seule CultureInfo . Il offre de meilleures performances qu’un appel correspondant à un CultureInfo constructeur. La méthode permet de 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 pas les substitutions de l’utilisateur. Si name a String.Empty la valeur, la méthode retourne la culture dite indifférente. Cela équivaut à récupérer la valeur de la InvariantCulture propriété. Si altName est String.Empty , la méthode utilise le système d’écriture et les règles de comparaison spécifiées par la culture dite indifférente.

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si name ou altName n’est pas un nom de culture valide. à partir de .NET Framework 4, cette méthode lève une exception 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. à 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 de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente 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

CultureInfo

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

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

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si culture n’est pas un identificateur de culture valide. à partir de .NET Framework 4, cette méthode lève une exception 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 culture du système d’exploitation ; si le système d’exploitation ne prend pas en charge cette culture, la méthode lève une 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 de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente 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

CultureInfo

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 cultures prédéfinis sur les systèmes Windows, consultez la colonne tag language 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, à partir de Windows 10, name peut être n’importe quelle balise de langage 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' CultureInfo objet retourné ne reflète pas les substitutions de l’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 ont besoin de charger efficacement plusieurs cultures.

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

Notes pour les appelants

.NET Framework 3,5 et les versions antérieures lèvent une exception ArgumentException si name n’est pas un nom de culture valide. à partir de .NET Framework 4, cette méthode lève une exception 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 .

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 de globalisation-indifférent est activé, par exemple, certains conteneurs d’ancrage et une culture autre que la culture dite indifférente est spécifiée.

Voir aussi

S’applique à