CultureAndRegionInfoBuilder Classe

Définition

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.

S’applique à