CultureAndRegionInfoBuilder Класс

Определение

Пространство имен:

System.Globalization

Сборка:

sysglobl.dll

Определяет пользовательский язык и региональные параметры, которые либо являются новыми, либо основываются на другом языке и региональных параметрах или на другой стране и регионе. Пользовательский язык и региональные параметры могут быть установлены на компьютере и в последующем использоваться любым приложением, запущенным на этом компьютере. Этот класс не наследуется.

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

Наследование

Object

CultureAndRegionInfoBuilder

Атрибуты

ComVisibleAttribute

Примеры

В следующем примере определяется пользовательский язык и региональные параметры ru-US, представляющий русский язык в США. В примере определяется пользовательский язык и региональные параметры путем загрузки параметров из российского объекта (Россия) CultureInfo и объекта США RegionInfo , а затем задается ряд CultureAndRegionInfoBuilder свойств. В примере регистрируется пользовательский язык и региональные параметры, а затем создается его экземпляр и делается текущим языком и региональными параметрами.

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

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для CultureAndRegionInfoBuilder.

Конструкторы

CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Инициализирует новый экземпляр класса CultureAndRegionInfoBuilder.

Свойства

AvailableCalendars	Возвращает или задает массив календарей, поддерживаемых этим объектом CultureAndRegionInfoBuilder.
CompareInfo	Возвращает или задает объект CompareInfo, определяющий способ сравнения строк для данного языка и региональных параметров.
ConsoleFallbackUICulture	Возвращает или задает альтернативный язык и региональные параметры пользовательского интерфейса, подходящие для консольных приложений, когда не подходит язык и региональные параметры графического пользовательского интерфейса по умолчанию.
CultureEnglishName	Возвращает или задает имя языка и региональных параметров на английском языке.
CultureName	Возвращает имя создаваемого языка и региональных параметров.
CultureNativeName	Возвращает или задает имя языка и региональных параметров в том формате и на том языке, которые заданы для отображения в этом языке и региональных параметрах.
CultureTypes	Возвращает значение CultureTypes, описывающее язык и региональные параметры, представленные текущим объектом CultureAndRegionInfoBuilder.
CurrencyEnglishName	Возвращает или задает на английском языке название валюты, используемой в стране или регионе, представленном объектом CultureAndRegionInfoBuilder.
CurrencyNativeName	Возвращает или задает местное название валюты, используемое в стране или регионе, представленном объектом CultureAndRegionInfoBuilder.
GeoId	Возвращает или задает уникальный идентификационный номер географического региона, страны, города или местности.
GregorianDateTimeFormat	Возвращает или задает объект DateTimeFormatInfo, определяющий формат даты и времени в соответствии с григорианским календарем.
IetfLanguageTag	Возвращает или задает имя языка и региональных параметров в соответствии со стандартом RFC 4646, посвященном тегам для идентификации языков.
IsMetric	Возвращает или задает значение, указывающее, использует ли страна или регион метрическую систему.
ISOCurrencySymbol	Возвращает или задает трехзначный символ денежной единицы в формате ISO 4217, связанный со страной или регионом.
IsRightToLeft	Возвращает или задает преобладающее направление строк текста в системе письма, связанной с текущим объектом CultureAndRegionInfoBuilder.
KeyboardLayoutId	Возвращает или задает идентификатор действующего языка ввода.
LCID	Возвращает идентификатор языка и региональных параметров для текущего объекта CultureAndRegionInfoBuilder.
NumberFormat	Возвращает или задает объект NumberFormatInfo, определяющий формат отображения чисел, денежной единицы и процентов, соответствующий языку и региональным параметрам.
Parent	Возвращает или задает объект CultureInfo, представляющий родительский язык и региональные параметры текущего пользовательского языка и региональных параметров.
RegionEnglishName	Возвращает или задает полное название страны или региона на английском языке.
RegionName	Возвращает название страны или региона для текущего объекта CultureAndRegionInfoBuilder.
RegionNativeName	Возвращает или задает полное название страны или региона на родном языке людей, использующих этот настраиваемый язык и региональные параметры.
TextInfo	Возвращает или задает объект TextInfo, который определяет систему письма, связанную с этим пользовательским языком и региональными параметрами.
ThreeLetterISOLanguageName	Возвращает или задает трехбуквенный код ISO 639-2 языка для данного пользовательского языка и региональных параметров.
ThreeLetterISORegionName	Возвращает или задает код из трех букв, определенный в формате ISO 3166 для страны или региона.
ThreeLetterWindowsLanguageName	Возвращает или задает трехбуквенный код для языка, определенный в формате Windows API.
ThreeLetterWindowsRegionName	Возвращает или задает код из трех букв, присвоенный операционной системой Windows стране или региону, представленному текущим пользовательским языком и региональными параметрами.
TwoLetterISOLanguageName	Возвращает или задает двухбуквенный код ISO 639-1 для языка текущего объекта CultureInfo.
TwoLetterISORegionName	Возвращает или задает код из двух букв, определенный в формате ISO 3166 для страны или региона.

Методы

CreateFromLdml(String)	Восстанавливает объект CultureAndRegionInfoBuilder из указанного XML-файла, содержащего представление объекта.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
LoadDataFromCultureInfo(CultureInfo)	Задает свойства текущего объекта CultureAndRegionInfoBuilder с помощью соответствующих свойств указанного объекта CultureInfo.
LoadDataFromRegionInfo(RegionInfo)	Задает свойства текущего объекта CultureAndRegionInfoBuilder с помощью соответствующих свойств указанного объекта RegionInfo.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Register()	Сохраняет текущий объект CultureAndRegionInfoBuilder в качестве пользовательского языка и региональных параметров на локальном компьютере и открывает приложениям доступ к этому языку и региональным параметрам. Для этого требуются полномочия администратора.
Save(String)	Создает XML-представление текущего объекта CultureAndRegionInfoBuilder в указанном файле.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unregister(String)	Удаляет пользовательский язык и региональные параметры с локального компьютера.