CultureAndRegionInfoBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit une culture personnalisée qui est nouvelle ou basée sur une autre culture et pays/région. La culture personnalisée peut être installée sur un ordinateur et utilisée par la suite par toute application qui s’exécute sur cet ordinateur. Cette classe ne peut pas être héritée.
public ref class CultureAndRegionInfoBuilder sealed
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class CultureAndRegionInfoBuilder
[<System.Runtime.InteropServices.ComVisible(false)>]
type CultureAndRegionInfoBuilder = class
Public NotInheritable Class CultureAndRegionInfoBuilder
- Héritage
-
CultureAndRegionInfoBuilder
- Attributs
Remarques
Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour CultureAndRegionInfoBuilder.
Example
L’exemple suivant définit une culture de ru-US personnalisée qui représente la langue russe dans l’États-Unis. L’exemple définit la culture personnalisée en chargeant les paramètres à partir de l’objet russe (Russie) CultureInfo et de l’objet américain RegionInfo , puis définit un certain nombre de CultureAndRegionInfoBuilder propriétés. L’exemple enregistre la culture personnalisée, puis l’instancie et la rend la culture actuelle.
using System;
using System.Globalization;
using System.Threading;
public class Example
{
public static void Main()
{
// Create a custom culture for ru-US.
CultureAndRegionInfoBuilder car1 = new CultureAndRegionInfoBuilder("ru-US",
CultureAndRegionModifiers.None);
car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"));
car1.LoadDataFromRegionInfo(new RegionInfo("en-US"));
car1.CultureEnglishName = "Russian (United States)";
car1.CultureNativeName = "русский (США)";
car1.CurrencyNativeName = "Доллар (США)";
car1.RegionNativeName = "США";
// Register the culture.
try {
car1.Register();
}
catch (InvalidOperationException) {
// Swallow the exception: the culture already is registered.
}
// Use the custom culture.
CultureInfo ci = CultureInfo.CreateSpecificCulture("ru-US");
Thread.CurrentThread.CurrentCulture = ci;
Console.WriteLine("Current Culture: {0}",
Thread.CurrentThread.CurrentCulture.Name);
Console.WriteLine("Writing System: {0}",
Thread.CurrentThread.CurrentCulture.TextInfo);
}
}
// The example displays the following output:
// Current Culture: ru-US
// Writing System: TextInfo - ru-US
Imports System.Globalization
Imports System.Threading
Module Example
Public Sub Main()
' Create a custom culture for ru-US.
Dim car1 As New CultureAndRegionInfoBuilder("ru-US", CultureAndRegionModifiers.None)
car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"))
car1.LoadDataFromRegionInfo(New RegionInfo("en-US"))
car1.CultureEnglishName = "Russian (United States)"
car1.CultureNativeName = "русский (США)"
car1.CurrencyNativeName = "Доллар (США)"
car1.RegionNativeName = "США"
' Register the culture.
Try
car1.Register()
Catch e As InvalidOperationException
' Swallow the exception: the culture already is registered.
End Try
' Use the custom culture.
Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("ru-US")
Thread.CurrentThread.CurrentCulture = ci
Console.WriteLine("Current Culture: {0}",
Thread.CurrentThread.CurrentCulture.Name)
Console.WriteLine("Writing System: {0}",
Thread.CurrentThread.CurrentCulture.TextInfo)
End Sub
End Module
' The example displays the following output:
' Current Culture: ru-US
' Writing System: TextInfo - ru-US
Constructeurs
| Nom | Description |
|---|---|
| CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) |
Initialise une nouvelle instance de la classe CultureAndRegionInfoBuilder. |
Propriétés
| Nom | Description |
|---|---|
| AvailableCalendars |
Obtient ou définit un tableau de calendriers pris en charge par cet CultureAndRegionInfoBuilder objet. |
| CompareInfo |
Obtient ou définit l’objet CompareInfo qui définit comment comparer des chaînes pour la culture. |
| ConsoleFallbackUICulture |
Obtient ou définit une autre culture d’interface utilisateur adaptée aux applications console lorsque la culture de l’interface utilisateur graphique par défaut est inappropriée. |
| CultureEnglishName |
Obtient ou définit le nom de la culture en anglais. |
| CultureName |
Obtient le nom de la culture en cours de création. |
| CultureNativeName |
Obtient ou définit le nom de la culture dans le format et la langue à afficher. |
| CultureTypes |
Obtient la valeur qui décrit la CultureTypes culture représentée par l’objet actuel CultureAndRegionInfoBuilder . |
| CurrencyEnglishName |
Obtient ou définit le nom, en anglais, de la devise utilisée dans le pays/région représenté par l’objet actuel CultureAndRegionInfoBuilder . |
| CurrencyNativeName |
Obtient ou définit le nom natif de la devise utilisée dans le pays/région représenté par l’objet actuel CultureAndRegionInfoBuilder . |
| GeoId |
Obtient ou définit un numéro d’identification unique pour une région géographique, un pays, une ville ou un emplacement. |
| GregorianDateTimeFormat |
Obtient ou définit un DateTimeFormatInfo objet qui définit le format des dates et des heures en fonction du calendrier grégorien. |
| IetfLanguageTag |
Obtient ou définit un nom de culture mis en forme conformément à la norme RFC 4646, « Balises pour l’identification des langues ». |
| IsMetric |
Obtient ou définit une valeur indiquant si le pays/la région utilise le système de métriques pour les mesures. |
| ISOCurrencySymbol |
Obtient ou définit le symbole monétaire ISO 4217 à trois caractères associé au pays/à la région. |
| IsRightToLeft |
Obtient ou définit la direction prédominante des lignes de texte dans le système d’écriture associé à l’objet actuel CultureAndRegionInfoBuilder . |
| KeyboardLayoutId |
Obtient ou définit l’identificateur de paramètres régionaux d’entrée actif. |
| LCID |
Obtient l’identificateur de culture de l’objet actuel CultureAndRegionInfoBuilder . |
| NumberFormat |
Obtient ou définit un NumberFormatInfo objet qui définit le format culturellement approprié d’affichage des nombres, de la devise et du pourcentage. |
| Parent |
Obtient ou définit l’objet CultureInfo qui représente la culture parente de la culture personnalisée actuelle. |
| RegionEnglishName |
Obtient ou définit le nom complet du pays/de la région en anglais. |
| RegionName |
Obtient le nom du pays/région de l’objet actif CultureAndRegionInfoBuilder . |
| RegionNativeName |
Obtient ou définit le nom complet du pays/de la région, tel que connu par les personnes de cette culture personnalisée. |
| TextInfo |
Obtient ou définit l’objet TextInfo qui définit le système d’écriture associé à cette culture personnalisée. |
| ThreeLetterISOLanguageName |
Obtient ou définit le code de trois lettres ISO 639-2 pour la langue de cette culture personnalisée. |
| ThreeLetterISORegionName |
Obtient ou définit le code à trois lettres défini dans ISO 3166 pour le pays/région. |
| ThreeLetterWindowsLanguageName |
Obtient ou définit le code à trois lettres pour la langue telle que définie dans l’API Windows. |
| ThreeLetterWindowsRegionName |
Obtient ou définit le code à trois lettres attribué par Windows au pays/région représenté par la culture personnalisée actuelle. |
| TwoLetterISOLanguageName |
Obtient ou définit le code à deux lettres ISO 639-1 pour la langue de l’objet actuel CultureInfo . |
| TwoLetterISORegionName |
Obtient ou définit le code à deux lettres défini dans ISO 3166 pour le pays/la région. |
Méthodes
| Nom | Description |
|---|---|
| CreateFromLdml(String) |
Reconstitue un CultureAndRegionInfoBuilder objet à partir d’un fichier XML spécifié qui contient une représentation de l’objet. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| LoadDataFromCultureInfo(CultureInfo) |
Définit les propriétés de l’objet actif CultureAndRegionInfoBuilder avec les propriétés correspondantes de l’objet spécifié CultureInfo . |
| LoadDataFromRegionInfo(RegionInfo) |
Définit les propriétés de l’objet actif CultureAndRegionInfoBuilder avec les propriétés correspondantes de l’objet spécifié RegionInfo . |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| Register() |
Conserve l’objet actuel CultureAndRegionInfoBuilder en tant que culture personnalisée sur l’ordinateur local et rend cette culture disponible pour les applications. Nécessite des privilèges d’administration. |
| Save(String) |
Écrit une représentation XML de l’objet actif CultureAndRegionInfoBuilder dans le fichier spécifié. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Unregister(String) |
Supprime une culture personnalisée de l’ordinateur local. |