CultureAndRegionInfoBuilder Klasa

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

sysglobl.dll

Definiuje kulturę niestandardową, która jest nowa lub oparta na innej kulturze i kraju/regionie. Kulturę niestandardową można zainstalować na komputerze, a następnie używać przez dowolną aplikację działającą na tym komputerze. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

CultureAndRegionInfoBuilder

Atrybuty

ComVisibleAttribute

Przykłady

W poniższym przykładzie zdefiniowano niestandardową kulturę ru-US, która reprezentuje język rosyjski w Stany Zjednoczone. W przykładzie zdefiniowano kulturę niestandardową przez załadowanie ustawień z obiektu rosyjskiego (Rosji) CultureInfo i obiektu USA RegionInfo , a następnie ustawienie wielu CultureAndRegionInfoBuilder właściwości. Przykład rejestruje kulturę niestandardową, a następnie tworzy jej wystąpienie i sprawia, że jest to bieżąca kultura.

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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla cultureAndRegionInfoBuilder.

Konstruktory

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inicjuje nowe wystąpienie klasy CultureAndRegionInfoBuilder.

Właściwości

AvailableCalendars	Pobiera lub ustawia tablicę kalendarzy obsługiwanych przez ten CultureAndRegionInfoBuilder obiekt.
CompareInfo	Pobiera lub ustawia CompareInfo obiekt, który definiuje sposób porównywania ciągów dla kultury.
ConsoleFallbackUICulture	Pobiera lub ustawia alternatywną kulturę interfejsu użytkownika odpowiednią dla aplikacji konsolowych, gdy domyślna kultura graficznego interfejsu użytkownika jest nieodpowiednia.
CultureEnglishName	Pobiera lub ustawia nazwę kultury w języku angielskim.
CultureName	Pobiera nazwę tworzonej kultury.
CultureNativeName	Pobiera lub ustawia nazwę kultury w formacie i języku ustawionym na wyświetlanie kultury.
CultureTypes	CultureTypes Pobiera wartość opisaną kulturę reprezentowaną przez bieżący CultureAndRegionInfoBuilder obiekt.
CurrencyEnglishName	Pobiera lub ustawia nazwę w języku angielskim waluty używanej w kraju/regionie reprezentowanym przez bieżący CultureAndRegionInfoBuilder obiekt.
CurrencyNativeName	Pobiera lub ustawia natywną nazwę waluty używanej w kraju/regionie reprezentowanym przez bieżący CultureAndRegionInfoBuilder obiekt.
GeoId	Pobiera lub ustawia unikatowy numer identyfikacyjny dla regionu geograficznego, kraju, miasta lub lokalizacji.
GregorianDateTimeFormat	Pobiera lub ustawia DateTimeFormatInfo obiekt, który definiuje format dat i godzin zgodnie z kalendarzem gregoriańskim.
IetfLanguageTag	Pobiera lub ustawia nazwę kultury sformatowaną zgodnie ze standardem RFC 4646 "Tagi identyfikacji języków".
IsMetric	Pobiera lub ustawia wartość wskazującą, czy kraj/region używa systemu metryk do pomiarów.
ISOCurrencySymbol	Pobiera lub ustawia trzyznaczny symbol waluty ISO 4217 skojarzony z krajem/regionem.
IsRightToLeft	Pobiera lub ustawia dominujący kierunek wierszy tekstu w systemie zapisu skojarzonym z bieżącym CultureAndRegionInfoBuilder obiektem.
KeyboardLayoutId	Pobiera lub ustawia aktywny identyfikator ustawień regionalnych danych wejściowych.
LCID	Pobiera identyfikator kultury dla bieżącego CultureAndRegionInfoBuilder obiektu.
NumberFormat	Pobiera lub ustawia NumberFormatInfo obiekt, który definiuje kulturowo odpowiedni format wyświetlania liczb, waluty i wartości procentowej.
Parent	Pobiera lub ustawia CultureInfo obiekt reprezentujący kulturę nadrzędną bieżącej kultury niestandardowej.
RegionEnglishName	Pobiera lub ustawia pełną nazwę kraju/regionu w języku angielskim.
RegionName	Pobiera nazwę kraju/regionu dla bieżącego CultureAndRegionInfoBuilder obiektu.
RegionNativeName	Pobiera lub ustawia pełną nazwę kraju/regionu znanego przez ludzi tej kultury niestandardowej.
TextInfo	Pobiera lub ustawia TextInfo obiekt, który definiuje system zapisu skojarzony z tą kulturą niestandardową.
ThreeLetterISOLanguageName	Pobiera lub ustawia trzyliterowy kod ISO 639-2 dla języka tej kultury niestandardowej.
ThreeLetterISORegionName	Pobiera lub ustawia trzyliterowy kod zdefiniowany w standardzie ISO 3166 dla kraju/regionu.
ThreeLetterWindowsLanguageName	Pobiera lub ustawia trzyliterowy kod języka zgodnie z definicją w interfejsie API systemu Windows.
ThreeLetterWindowsRegionName	Pobiera lub ustawia trzyliterowy kod przypisany przez system Windows do kraju/regionu reprezentowanego przez bieżącą kulturę niestandardową.
TwoLetterISOLanguageName	Pobiera lub ustawia dwuliterowy kod ISO 639-1 dla języka bieżącego CultureInfo obiektu.
TwoLetterISORegionName	Pobiera lub ustawia dwuliterowy kod zdefiniowany w standardzie ISO 3166 dla kraju/regionu.

Metody

CreateFromLdml(String)	Rekonstytuuje CultureAndRegionInfoBuilder obiekt z określonego pliku XML, który zawiera reprezentację obiektu.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
LoadDataFromCultureInfo(CultureInfo)	Ustawia właściwości bieżącego CultureAndRegionInfoBuilder obiektu z odpowiednimi właściwościami określonego CultureInfo obiektu.
LoadDataFromRegionInfo(RegionInfo)	Ustawia właściwości bieżącego CultureAndRegionInfoBuilder obiektu z odpowiednimi właściwościami określonego RegionInfo obiektu.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Register()	Utrwala bieżący CultureAndRegionInfoBuilder obiekt jako kulturę niestandardową na komputerze lokalnym i udostępnia ten obiekt aplikacjom. Wymaga uprawnień administracyjnych.
Save(String)	Zapisuje reprezentację XML bieżącego CultureAndRegionInfoBuilder obiektu w określonym pliku.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Unregister(String)	Usuwa kulturę niestandardową z komputera lokalnego.