CultureAndRegionInfoBuilder Klasse

Definition

Namespace:: System.Globalization

Assembly:: sysglobl.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert eine benutzerdefinierte Kultur, die neu ist oder auf einer anderen Kultur und 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

Hinweise

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für CultureAndRegionInfoBuilder.

Beispiel

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 (Russland) CultureInfo -Objekt und dem US-Objekt RegionInfo geladen und anschließend eine Reihe von CultureAndRegionInfoBuilder Eigenschaften festgelegt werden. Im Beispiel wird die benutzerdefinierte Kultur registriert und anschließend instanziiert und 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

Konstruktoren

Name	Beschreibung
CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)	Initialisiert eine neue Instanz der CultureAndRegionInfoBuilder-Klasse.

Eigenschaften

Name	Beschreibung
AvailableCalendars	Dient zum Abrufen oder Festlegen eines Arrays von Kalendern, die von diesem CultureAndRegionInfoBuilder Objekt unterstützt werden.
CompareInfo	Dient zum Abrufen oder Festlegen des CompareInfo Objekts, das definiert, wie Zeichenfolgen für die Kultur verglichen werden.
ConsoleFallbackUICulture	Ruft eine alternative Benutzeroberflächenkultur ab, die für Konsolenanwendungen geeignet ist, wenn die Standardmäßige Benutzeroberflächenkultur ungeeignet ist, oder legt diese fest.
CultureEnglishName	Dient zum Abrufen oder Festlegen des Kulturnamens in Englisch.
CultureName	Ruft den Namen der zu erstellenden Kultur ab.
CultureNativeName	Ruft den Kulturnamen im Format und in der Sprache ab, die für die Anzeige der Kultur festgelegt ist, oder legt diesen fest.
CultureTypes	Ruft den CultureTypes Wert ab, der die Kultur beschreibt, die durch das aktuelle CultureAndRegionInfoBuilder Objekt dargestellt wird.
CurrencyEnglishName	Dient zum Abrufen oder Festlegen des Namens in Englisch der Währung, die in dem Land/der Region verwendet wird, das durch das aktuelle CultureAndRegionInfoBuilder Objekt dargestellt wird.
CurrencyNativeName	Dient zum Abrufen oder Festlegen des systemeigenen Namens der Währung, die in dem Land/der Region verwendet wird, das durch das aktuelle CultureAndRegionInfoBuilder Objekt dargestellt wird.
GeoId	Dient zum Abrufen oder Festlegen einer eindeutigen Identifikationsnummer für eine geografische Region, ein Land, eine Stadt oder einen Standort.
GregorianDateTimeFormat	Dient zum Abrufen oder Festlegen eines DateTimeFormatInfo Objekts, das das Format von Datums- und Uhrzeitangaben gemäß dem gregorianischen Kalender definiert.
IetfLanguageTag	Dient zum Abrufen oder Festlegen eines Kulturnamens, der gemäß dem RFC 4646-Standard "Tags for the Identification of Languages" formatiert ist.
IsMetric	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Land/die Region das Metriksystem für Messungen verwendet.
ISOCurrencySymbol	Ruft das dreistellige ISO 4217-Währungssymbol ab, das dem Land/der Region zugeordnet ist, oder legt es fest.
IsRightToLeft	Dient zum Abrufen oder Festlegen der vorherrschenden Richtung von Textzeilen im Schreibsystem, das dem aktuellen CultureAndRegionInfoBuilder Objekt zugeordnet ist.
KeyboardLayoutId	Dient zum Abrufen oder Festlegen des aktiven Eingabegebietsschemabezeichners.
LCID	Ruft den Kulturbezeichner für das aktuelle CultureAndRegionInfoBuilder Objekt ab.
NumberFormat	Dient zum Abrufen oder Festlegen eines NumberFormatInfo Objekts, das das kulturell geeignete Format der Anzeige von Zahlen, Währungen und Prozentsätzen definiert.
Parent	Dient zum Abrufen oder Festlegen des CultureInfo Objekts, das die übergeordnete Kultur der aktuellen benutzerdefinierten Kultur darstellt.
RegionEnglishName	Dient zum Abrufen oder Festlegen des vollständigen Namens des Landes/der Region in Englisch.
RegionName	Ruft den Namen des Landes/der Region für das aktuelle CultureAndRegionInfoBuilder Objekt ab.
RegionNativeName	Ruft den vollständigen Namen des Landes/der Region ab, der von den Personen dieser benutzerdefinierten Kultur bekannt ist, oder legt diesen fest.
TextInfo	Ruft ab oder legt das TextInfo Objekt fest, das das Schreibsystem definiert, das dieser benutzerdefinierten Kultur zugeordnet ist.
ThreeLetterISOLanguageName	Dient zum Abrufen oder Festlegen des ISO 639-2-Drei-Buchstaben-Codes für die Sprache dieser benutzerdefinierten Kultur.
ThreeLetterISORegionName	Ruft den drei buchstabenigen Code ab, der in ISO 3166 für das Land/die Region definiert ist, oder legt den code fest.
ThreeLetterWindowsLanguageName	Ruft den drei buchstabenigen Code für die Sprache ab, die in der Windows-API definiert ist, oder legt den Code fest.
ThreeLetterWindowsRegionName	Dient zum Abrufen oder Festlegen des von Windows zugewiesenen Drei-Buchstaben-Codes für das Land/die Region, das durch die aktuelle benutzerdefinierte Kultur dargestellt wird.
TwoLetterISOLanguageName	Dient zum Abrufen oder Festlegen des ISO 639-1-Codes mit zwei Buchstaben für die Sprache des aktuellen CultureInfo Objekts.
TwoLetterISORegionName	Dient zum Abrufen oder Festlegen des in ISO 3166 für das Land/die Region definierten zwei Buchstabencode.

Methoden

Name	Beschreibung
CreateFromLdml(String)	Konfiguriert 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()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die 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 der aktuellen Object. (Geerbt von Object)
Register()	Speichert das aktuelle CultureAndRegionInfoBuilder Objekt als benutzerdefinierte Kultur auf dem lokalen Computer und stellt diese Kultur Anwendungen zur Verfügung. Erfordert Administratorrechte.
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:

Feedback

War diese Seite hilfreich?