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