Freigeben über


CultureAndRegionInfoBuilder Klasse

Definition

Definiert eine benutzerdefinierte Kultur, die neu ist oder auf einer anderen Kultur und einem anderen Land oder einer anderen Region basiert. Die benutzerdefinierte Kultur kann auf einem Computer installiert und anschließend von jeder Anwendung verwendet werden, die auf diesem Computer ausgeführt wird. Diese Klasse kann nicht vererbt werden.

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
Vererbung
CultureAndRegionInfoBuilder
Attribute

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte ru-US-Kultur definiert, die die russische Sprache im USA darstellt. Im Beispiel wird die benutzerdefinierte Kultur definiert, indem Einstellungen aus dem Russischen Objekt (Russland) CultureInfo und dem US-Objekt RegionInfo geladen werden, und dann eine Reihe von CultureAndRegionInfoBuilder Eigenschaften festgelegt werden. Das Beispiel registriert die benutzerdefinierte Kultur, instanziiert sie dann und macht sie zur aktuellen Kultur.

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

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für CultureAndRegionInfoBuilder.

Konstruktoren

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Initialisiert eine neue Instanz der CultureAndRegionInfoBuilder-Klasse.

Eigenschaften

AvailableCalendars

Ruft ein Array von Kalendern ab, die von diesem CultureAndRegionInfoBuilder-Objekt unterstützt werden, oder legt dieses fest.

CompareInfo

Ruft das CompareInfo-Objekt ab, in dem festgelegt wird, wie Zeichenfolgen für die Kultur verglichen werden, oder legt dieses fest.

ConsoleFallbackUICulture

Ruft die bei einer ungeeigneten Standard-GUI-Kultur geeignete alternative GUI-Kultur für Konsolenanwendungen ab oder legt diese fest.

CultureEnglishName

Ruft den englischen Kulturnamen ab oder legt diesen fest.

CultureName

Ruft den Namen der Kultur ab, die erstellt wird.

CultureNativeName

Ruft den Kulturnamen im Format und der Sprache ab, das bzw. die in der Kultur für die Anzeige festgelegt sind, oder legt diesen fest.

CultureTypes

Ruft den CultureTypes-Wert ab, mit dem die durch das aktuelle CultureAndRegionInfoBuilder-Objekt dargestellte Kultur beschrieben wird.

CurrencyEnglishName

Ruft den englischen Namen der Währung ab, die in dem Land oder der Region verwendet wird, die durch das aktuelle CultureAndRegionInfoBuilder-Objekt dargestellt wird, oder legt diesen Namen fest.

CurrencyNativeName

Ruft den systemeigenen Namen der Währung ab, die in dem Land oder der Region verwendet wird, die durch das aktuelle CultureAndRegionInfoBuilder-Objekt dargestellt wird, oder legt diesen Namen fest.

GeoId

Ruft eine eindeutige Identifikationsnummer für eine geographische Region, ein Land, eine Stadt oder einen Ort ab oder legt diese fest.

GregorianDateTimeFormat

Ruft ein DateTimeFormatInfo-Objekt ab, das das Format von Datumsangaben und Uhrzeiten nach dem gregorianischen Kalender definiert, oder legt dieses fest.

IetfLanguageTag

Ruft einen nach RFC 4646, "Tags for the Identification of Languages", formatierten Kulturnamen ab oder legt diesen fest.

IsMetric

Ruft einen Wert ab, der angibt, ob für Maßeinheiten in dem Land bzw. der Region das metrische System verwendet wird, oder legt diesen fest.

ISOCurrencySymbol

Ruft das aus drei Zeichen bestehende, dem Land bzw. der Region nach ISO 4217 zugeordnete Währungssymbol ab.

IsRightToLeft

Ruft die vorherrschende Schreibrichtung der Textzeilen im Schriftsystem ab, das dem aktuellen CultureAndRegionInfoBuilder-Objekt zugeordnet ist, oder legt diese fest.

KeyboardLayoutId

Ruft den Bezeichner für das aktive Eingabegebietsschema ab oder legt diesen fest.

LCID

Ruft den Kulturbezeichner für das aktuelle CultureAndRegionInfoBuilder-Objekt ab.

NumberFormat

Ruft ein NumberFormatInfo-Objekt ab, das das für die Kultur spezifische Format zum Anzeigen von Zahlen, Währungen und Prozentsätzen definiert, oder legt dieses fest.

Parent

Ruft das CultureInfo-Objekt ab, das die übergeordnete Kultur der aktuellen benutzerdefinierten Kultur darstellt, oder legt dieses fest.

RegionEnglishName

Ruft den vollständigen englischen Namen des Landes bzw. der Region ab oder legt diesen fest.

RegionName

Ruft den Namen des Landes bzw. der Region für das aktuelle CultureAndRegionInfoBuilder-Objekt ab.

RegionNativeName

Ruft den vollständigen Namen des Landes bzw. der Region ab, der örtlich in dieser benutzerdefinierten Kultur verwendet wird, oder legt diesen fest.

TextInfo

Ruft das TextInfo-Objekt ab, das das dieser benutzerdefinierten Kultur zugeordnete Schriftsystem definiert, oder legt dieses fest.

ThreeLetterISOLanguageName

Ruft den aus drei Buchstaben bestehenden Code nach ISO 639-2 für die Sprache dieser benutzerdefinierten Kultur ab oder legt diesen fest.

ThreeLetterISORegionName

Ruft den aus drei Buchstaben bestehenden Code nach ISO 3166 für das Land bzw. die Region ab oder legt diesen fest.

ThreeLetterWindowsLanguageName

Ruft den aus drei Buchstaben bestehenden Code für die Sprache ab, wie er in der Windows-API definiert ist, oder legt diesen fest.

ThreeLetterWindowsRegionName

Ruft den aus drei Buchstaben bestehenden Code ab, der von Windows dem Land bzw. der Region zugeordnet wird, das bzw. die durch die aktuelle benutzerdefinierte Kultur dargestellt wird, oder legt diesen fest.

TwoLetterISOLanguageName

Ruft den aus zwei Buchstaben bestehenden Code nach ISO 639-1 für die Sprache des aktuellen CultureInfo-Objekts ab oder legt diesen fest.

TwoLetterISORegionName

Ruft den aus zwei Buchstaben bestehenden Code nach ISO 3166 für das Land bzw. die Region ab oder legt diesen fest.

Methoden

CreateFromLdml(String)

Rekonstruiert ein CultureAndRegionInfoBuilder-Objekt aus einer angegebenen XML-Datei, die eine Darstellung des Objekts enthält.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
LoadDataFromCultureInfo(CultureInfo)

Legt die Eigenschaften des aktuellen CultureAndRegionInfoBuilder-Objekts mit den entsprechenden Eigenschaften des angegebenen CultureInfo-Objekts fest.

LoadDataFromRegionInfo(RegionInfo)

Legt die Eigenschaften des aktuellen CultureAndRegionInfoBuilder-Objekts mit den entsprechenden Eigenschaften des angegebenen RegionInfo-Objekts fest.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Register()

Behält das aktuelle CultureAndRegionInfoBuilder-Objekt als benutzerdefinierte Kultur auf dem lokalen Computer bei und macht diese Kultur für Anwendungen verfügbar. Erfordert Administratorberechtigungen.

Save(String)

Schreibt eine XML-Darstellung des aktuellen CultureAndRegionInfoBuilder-Objekts in die angegebene Datei.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Unregister(String)

Löscht eine benutzerdefinierte Kultur vom lokalen Computer.

Gilt für: