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 的详细信息，请参阅 CultureAndRegionInfoBuilder 的补充 API 说明。

构造函数

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 标准“Tags for the Identification of Languages”（语言标识标记）进行格式化的区域性名称。
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	获取或设置当前 CultureInfo 对象的语言的由两个字母组成的 ISO 639-1 代码。
TwoLetterISORegionName	获取或设置在 ISO 3166 中定义的由两个字母组成的国家/地区代码。

方法

CreateFromLdml(String)	用一个包含对象表示形式的指定 XML 文件重构 CultureAndRegionInfoBuilder 对象。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
LoadDataFromCultureInfo(CultureInfo)	用指定 CultureInfo 对象的相应属性设置当前 CultureAndRegionInfoBuilder 对象的属性。
LoadDataFromRegionInfo(RegionInfo)	用指定 RegionInfo 对象的相应属性设置当前 CultureAndRegionInfoBuilder 对象的属性。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Register()	将当前 CultureAndRegionInfoBuilder 对象保持为本地计算机上的一个自定义区域性，并使该区域性可供应用程序使用。 需要管理特权。
Save(String)	将当前 CultureAndRegionInfoBuilder 对象的 XML 表示形式写入指定的文件。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Unregister(String)	从本地计算机中删除自定义区域性。