Поделиться через


CultureAndRegionInfoBuilder Класс

Определение

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

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
Наследование
CultureAndRegionInfoBuilder
Атрибуты

Примеры

В следующем примере определяется пользовательский язык и региональные параметры 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)

Удаляет пользовательский язык и региональные параметры с локального компьютера.

Применяется к