Constructeur System.Globalization.CultureAndRegionInfoBuilder

Cet article vous offre des remarques complémentaires à la documentation de référence pour cette API.

Cet article concerne le CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) constructeur.

Le cultureName paramètre spécifie le nom du nouvel CultureAndRegionInfoBuilder objet.

Le flags paramètre est utilisé pour une CultureAndRegionModifiers valeur qui spécifie si le nouvel CultureAndRegionInfoBuilder objet est une nouvelle culture personnalisée ou remplace une culture neutre existante, une culture spécifique ou des paramètres régionaux Windows.

Si le cultureName paramètre spécifie une culture .NET existante, une culture personnalisée inscrite ou une culture générée à partir de paramètres régionaux Windows, le CultureAndRegionInfoBuilder constructeur remplit automatiquement le nouvel CultureAndRegionInfoBuilder objet avec des informations de culture et de pays/région.

Remplissez le nouvel CultureAndRegionInfoBuilder objet avec des informations de culture et de pays/région en appelant les méthodes et LoadDataFromRegionInfo les LoadDataFromCultureInfo méthodes.

Noms de culture personnalisés

Le format préféré du cultureName paramètre pour une nouvelle culture personnalisée est « [prefix-][language-region][-…suffix]]] », où le language composant est requis et les prefixregioncomposants , et suffix les composants sont facultatifs. La longueur maximale de chaque composant est de 8 caractères et la longueur maximale du paramètre entier cultureName est de 84 caractères.

Le prefix composant est l’identification IANA (Internet Assigned Numbers Authority). Spécifiez « i- » ou « I- » pour les noms de culture inscrits auprès de l’IANA, ou « x- » ou « X- » pour les noms de culture réservés à une utilisation privée. Sinon, le préfixe n’est pas obligatoire. Pour plus d’informations, consultez RFC 4646, « Balises pour l’identification des langues ».

Le language composant du cultureName paramètre spécifie un code à deux lettres minuscules dérivé de la norme ISO 639-1 et region spécifie un code à deux lettres majuscules dérivé de la norme ISO 3166. Par exemple, en-US représente l’anglais tel qu’il est parlé dans le États-Unis. L’absence du region composant signifie une culture neutre.

C’est cultureName le même que le nom d’une culture incluse dans .NET signifie une culture de remplacement (remplacement). Les valeurs qui peuvent être affectées aux propriétés d’une culture de remplacement sont limitées. Pour plus d’informations sur ces limitations, consultez les exceptions pour chaque propriété.

L’application utilise le suffix composant pour distinguer les cultures similaires. Par exemple, deux entreprises, ABC et XYZ, créent et partagent un nouveau service web ASP.NET pour promouvoir leurs produits dans différents marchés du monde entier. Les pages Web du service affichent des informations telles que le logo régional et le numéro de téléphone local de chaque entreprise en fonction de la culture de l’utilisateur. Le contenu propre à la culture pour chaque page web se trouve dans des fichiers de ressources distincts identifiés par le nom de la culture et qualifiés par nom de société. Par exemple, les fichiers de ressources pour les cultures en-US et ja-JP sont nommés en-US-ABC, en-US-XYZ, ja-JP-ABC et ja-JP-XYZ. Les suffixes « ABC » et « XYZ » permettent au service Web d’utiliser la même logique d’application pour afficher différentes informations spécifiques au marché.

Le suffix composant peut se composer de sous-composants, où chaque sous-composant est délimité par un trait d’union et la longueur maximale de chaque sous-composant est de 8 caractères. Par exemple, si « en-US-honda-cars » est le cultureName paramètre, « -honda-cars » est le suffix composant.