Partage via


CultureAndRegionInfoBuilder Classe

Définition

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
CultureAndRegionInfoBuilder
Attributs

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 à