CultureAndRegionInfoBuilder Classe

Référence

Définition

Espace de noms:: System.Globalization

Assembly:: sysglobl.dll

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 sur un autre pays/région. La culture personnalisée peut être installée sur un ordinateur et être utilisée ultérieurement par n'importe quelle 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: Object
CultureAndRegionInfoBuilder

Attributs: ComVisibleAttribute

Exemples

L’exemple suivant définit une culture ru-US personnalisée qui représente la langue russe dans le États-Unis. L’exemple définit la culture personnalisée en chargeant des 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 inscrit la culture personnalisée, puis l’instancie et en fait 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

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour CultureAndRegionInfoBuilder.

Constructeurs

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Initialise une nouvelle instance de la classe CultureAndRegionInfoBuilder.

Propriétés

AvailableCalendars	Obtient ou définit un tableau de calendriers pris en charge par cet objet CultureAndRegionInfoBuilder.
CompareInfo	Obtient ou définit l'objet CompareInfo qui définit le mode de comparaison des chaînes de la culture.
ConsoleFallbackUICulture	Obtient ou définit une autre culture de l'interface utilisateur qui convient aux applications console lorsque la culture de l'interface graphique utilisateur par défaut est inappropriée.
CultureEnglishName	Obtient ou définit le nom de culture en anglais.
CultureName	Nom de la culture en cours de création.
CultureNativeName	Obtient ou définit le nom de culture au format et dans la langue pour lesquels la culture est configurée.
CultureTypes	Obtient la valeur CultureTypes qui décrit la culture représentée par l'objet CultureAndRegionInfoBuilder actuel.
CurrencyEnglishName	Obtient ou définit le nom, en anglais, de la devise utilisée dans le pays ou la région représentés par l'objet CultureAndRegionInfoBuilder actuel.
CurrencyNativeName	Obtient ou définit le nom natif de la devise utilisée dans le pays ou la région représentés par l'objet CultureAndRegionInfoBuilder actuel.
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 objet DateTimeFormatInfo qui définit le format des dates et des heures selon le calendrier grégorien.
IetfLanguageTag	Obtient ou définit un nom de culture mis en forme selon la norme RFC 4646, « Tags for the Identification of Languages ».
IsMetric	Obtient ou définit une valeur qui indique si le pays ou la région utilise le système métrique pour les mesures.
ISOCurrencySymbol	Obtient ou définit le symbole de devise à trois caractères défini dans la norme ISO 4217 pour le pays ou la région.
IsRightToLeft	Obtient ou définit le sens prédominant des lignes de texte dans le système d'écriture associé à l'objet CultureAndRegionInfoBuilder actuel.
KeyboardLayoutId	Obtient ou définit l'identificateur des paramètres régionaux d'entrée actifs.
LCID	Obtient l'identificateur de culture de l'objet CultureAndRegionInfoBuilder actuel.
NumberFormat	Obtient ou définit un objet NumberFormatInfo qui définit le format d'affichage des nombres, devises et pourcentages approprié pour la culture.
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 ou de la région en anglais.
RegionName	Obtient le nom du pays ou de la région pour l'objet CultureAndRegionInfoBuilder actuel.
RegionNativeName	Obtient ou définit le nom complet du pays ou de la région tel qu'il est 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 ISO 639-2 de trois lettres correspondant à la langue de cette culture personnalisée.
ThreeLetterISORegionName	Obtient ou définit le code de trois lettres défini dans ISO 3166 pour le pays ou la région.
ThreeLetterWindowsLanguageName	Obtient ou définit le code de trois lettres correspondant à la langue, tel que défini dans l'API Windows.
ThreeLetterWindowsRegionName	Obtient ou définit le code à trois lettres affecté par Windows au pays ou à la 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 CultureInfo actuel.
TwoLetterISORegionName	Obtient ou définit le code à deux lettres défini dans ISO 3166 pour le pays ou la région.

Méthodes

CreateFromLdml(String)	Reconstitue un objet CultureAndRegionInfoBuilder 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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
LoadDataFromCultureInfo(CultureInfo)	Définit les propriétés de l'objet CultureAndRegionInfoBuilder actuel avec les propriétés correspondantes de l'objet CultureInfo spécifié.
LoadDataFromRegionInfo(RegionInfo)	Définit les propriétés de l'objet CultureAndRegionInfoBuilder actuel avec les propriétés correspondantes de l'objet RegionInfo spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Register()	Fait persister l'objet CultureAndRegionInfoBuilder actuel comme une culture personnalisée sur l'ordinateur local et rend cette culture disponible aux applications. Requiert des privilèges administratifs.
Save(String)	Écrit une représentation XML de l'objet CultureAndRegionInfoBuilder actuel 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.

S’applique à

Partager via