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(String, Boolean)

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

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.

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

GetCultureInfo(String, Boolean)

Récupère une instance mise en cache et en lecture seule d'une culture.Retrieves a cached, read-only instance of a 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.The name of a culture. Il ne respecte pas la casse.It is not case-sensitive.

predefinedOnly
Boolean

true en cas de demande de création d’une instance d’une culture connue de la plateforme.true if requesting to create an instance of a culture that is known by the platform. 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.false if it is ok to retreive a made-up culture even if the platform does not carry data for it.

Retours

CultureInfo

Instance en lecture seule d’une culture.A read-only instance of a culture.

Remarques

Par défaut, lorsque vous tentez 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 les données d’autres cultures ou certaines valeurs constantes.By default, when trying to create any culture and the underlying platform (Windows NLS or ICU) does not carry specific data for this culture, the platform will try constructing a culture with data from other cultures or some constant values.

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.Setting predefinedOnly to true will ensure a culture is created only if the platform has real data for that culture.

S’applique à

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

CultureInfo

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 il peut s’agir de 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 GetCultureInfo méthode obtient un objet mis en cache et en lecture seule CultureInfo .The GetCultureInfo method obtains a cached, read-only CultureInfo object. Il offre de meilleures performances qu’un appel correspondant à un CultureInfo constructeur.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 name paramètre, 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 a String.Empty la valeur, 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 InvariantCulture propriété.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ées 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

Le .NET Framework 3.5.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.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 .NET Framework 4.NET Framework 4 , cette méthode lève une exception CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous .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 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.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 .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 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.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 à

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

CultureInfo

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' CultureInfo objet 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

Le .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une exception 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 .NET Framework 4.NET Framework 4 , cette méthode lève une exception CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous .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 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 .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

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

CultureInfo

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

Si name est le nom de la culture actuelle, l' CultureInfo objet 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 a String.Empty la valeur, 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 InvariantCulture propriété.This is equivalent to retrieving the value of the InvariantCulture property.

Notes pour les appelants

Le .NET Framework 3.5.NET Framework 3.5 et les versions antérieures lèvent une exception 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 .NET Framework 4.NET Framework 4 , cette méthode lève une exception CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. À compter des applications qui s’exécutent sous .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 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 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.

Voir aussi

S’applique à