CultureAndRegionInfoBuilder Klasse

Definition

Namespace:

System.Globalization

Assembly:

sysglobl.dll

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

Object

CultureAndRegionInfoBuilder

Attribute

ComVisibleAttribute

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.