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 retreiver une culture composée même si la plateforme ne transporte pas de données pour elle.

Retours

CultureInfo

Instance en lecture seule d’une culture.

Remarques

Par défaut, lors de la tentative de création d’une culture et de la plateforme sous-jacente (Windows NLS ou ICU) ne comporte 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.

Le paramètre predefinedOnly pour true garantir 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

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 culture prédéfinis sur Windows systèmes, 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 il peut s’agir d’une 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 pas les remplacements d’utilisateur. Si name c’est le cas String.Empty, la méthode retourne la culture indifférente. Cela équivaut à récupérer la valeur de la InvariantCulture propriété. Si altName c’est le cas String.Empty, la méthode utilise le système d’écriture et les règles de comparaison spécifiées par la culture indifférente.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException nom de culture valide ou name altName non. À 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 ce 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 ce 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 est en cours d’exécution dans un environnement où le mode globalisation-invariant est activé, par exemple, certains conteneurs Docker et une culture autre que la culture 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 au lieu de LCID. Pour les paramètres régionaux personnalisés, le nom des paramètres régionaux est requis.

S’il culture s’agit de l’identificateur de paramètres régionaux de la culture actuelle, l’objet retourné CultureInfo ne reflète aucune substitution d’utilisateur.

Notes pour les appelants

.NET Framework 3.5 et versions antérieures lèvent un ArgumentException culture identificateur 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 ultérieures sur Windows 7 ou 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 les versions .NET 6 et ultérieures, une valeur CultureNotFoundException est levée si l’application s’exécute dans un environnement où le mode globalisation-invariant 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

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 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, à partir de Windows 10, name il peut s’agir d’une 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.

S’il name s’agit du nom de la culture actuelle, l’objet retourné CultureInfo ne reflète pas les remplacements d’utilisateurs. Cela rend la méthode adaptée aux applications ou outils serveur qui n’ont pas de compte d’utilisateur réel sur le système et qui doivent charger efficacement plusieurs cultures.

Si name c’est String.Emptyle cas, 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 nom de culture valide s’il name n’est pas 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 ce 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 est en cours d’exécution dans un environnement où le mode globalisation-invariant est activé, par exemple, certains conteneurs Docker et une culture autre que la culture indifférente est spécifiée.

Voir aussi

S’applique à