CultureInfo.GetCultureInfo Méthode

Définition

Récupère une instance mise en cache et en lecture seule d'une culture.Retrieves a cached, read-only instance of a culture.

Surcharges

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é.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

Récupère une instance mise en cache et en lecture seule d'une culture en utilisant le nom de culture spécifié.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, String)

Récupère une instance mise en cache et en lecture seule d'une culture.Retrieves a cached, read-only instance of a 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.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another 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é.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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).A locale identifier (LCID).

Retours

Objet CultureInfo en lecture seule.A read-only CultureInfo object.

Exceptions

culture est inférieur à zéro.culture is less than zero.

culture spécifie une culture qui n’est pas prise en charge.culture specifies a culture that is not supported. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Caller section for more information.

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.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. Pour les paramètres régionaux personnalisés, le nom des paramètres régionaux est obligatoire.For custom locales, the locale name is required.

Si culture est l’identificateur de paramètres régionaux de la culture actuelle, l’objet CultureInfo retourné ne reflète pas les substitutions de l’utilisateur.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si culture n’est pas un identificateur de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. À partir de la .NET Framework 4.NET Framework 4, cette méthode lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est 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.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException.

Voir aussi

GetCultureInfo(String)

Récupère une instance mise en cache et en lecture seule d'une culture en utilisant le nom de culture spécifié.Retrieves a cached, read-only instance of a culture using the specified culture name.

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.The name of a culture. name ne respecte pas la casse.name is not case-sensitive.

Retours

Objet CultureInfo en lecture seule.A read-only CultureInfo object.

Exceptions

name a la valeur null.name is null.

name spécifie une culture qui n’est pas prise en charge.name specifies a culture that is not supported. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Callers section for more information.

Remarques

Pour obtenir la liste des noms de cultures 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.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

La méthode GetCultureInfo récupère un objet CultureInfo en lecture seule mis en cache.The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Il offre de meilleures performances qu’un appel correspondant au constructeur CultureInfo.CultureInfo(String).It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Si name est le nom de la culture actuelle, l’objet CultureInfo retourné ne reflète pas les substitutions de l’utilisateur.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. 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.This makes the method suitable for server applications or tools that do not have a real user account on the system and that need to load multiple cultures efficiently.

Si name est String.Empty, la méthode retourne la culture dite indifférente.If name is String.Empty, the method returns the invariant culture. Cela équivaut à récupérer la valeur de la propriété InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si name n’est pas un nom de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. À partir de la .NET Framework 4.NET Framework 4, cette méthode lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est name du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture et que name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException.

Voir aussi

GetCultureInfo(String, String)

Récupère une instance mise en cache et en lecture seule d'une culture.Retrieves a cached, read-only instance of a 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.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another 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.The name of a culture. name ne respecte pas la casse.name is not case-sensitive.

altName
String

Nom d’une culture qui fournit les objets TextInfo et CompareInfo utilisés pour initialiser name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName ne respecte pas la casse.altName is not case-sensitive.

Retours

Objet CultureInfo en lecture seule.A read-only CultureInfo object.

Exceptions

name ou altName est null.name or altName is null.

name ou altName spécifie une culture qui n’est pas pris en charge.name or altName specifies a culture that is not supported. Pour plus d’informations, consultez la section Remarques à l’attention des appelants.See the Notes to Callers section for more information.

Remarques

Pour obtenir la liste des noms de cultures 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.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Les noms de culture respectent la norme définie par BCP 47.Culture names follow the standard defined by BCP 47. En outre, à compter de Windows 10, name peut être n’importe quelle balise de langage BCP-47 valide.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

La méthode GetCultureInfo obtient un objet CultureInfo en lecture seule mis en cache.The GetCultureInfo method obtains a cached, read-only CultureInfo object. Il offre de meilleures performances qu’un appel correspondant à un constructeur CultureInfo.It offers better performance than a corresponding call to a CultureInfo constructor. La méthode permet de créer une culture similaire à celle spécifiée par le paramètre name, mais avec des règles de tri et de casse différentes.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Si name ou altName est le nom de la culture actuelle, les objets retournés ne reflètent pas les substitutions de l’utilisateur.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Si name est String.Empty, la méthode retourne la culture dite indifférente.If name is String.Empty, the method returns the invariant culture. Cela équivaut à récupérer la valeur de la propriété InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property. Si altName est String.Empty, la méthode utilise le système d’écriture et les règles de comparaison spécifiés par la culture dite indifférente.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

Notes pour les appelants

La .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une ArgumentException si name ou altName n’est pas un nom de culture valide.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name or altName is not a valid culture name. À partir de la .NET Framework 4.NET Framework 4, cette méthode lève une CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est name du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture et que name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une exception CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception. À compter des applications qui s’exécutent sous le .NET Framework 4.NET Framework 4 ou version ultérieure sur Windows 7 ou version ultérieure, la méthode tente de récupérer un objet CultureInfo dont l’identificateur est name du système d’exploitation ; Si le système d’exploitation ne prend pas en charge cette culture et que name n’est pas le nom d’une culture supplémentaire ou de remplacement, la méthode lève une exception CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Voir aussi

S’applique à