CultureAndRegionInfoBuilder 类    
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义一个新型或基于其他区域性和国家/地区的自定义区域性。 自定义区域性可以安装在计算机上,然后由运行在该计算机上的任何应用程序使用。 此类不能被继承。
public ref class CultureAndRegionInfoBuilder sealed[System.Runtime.InteropServices.ComVisible(false)]
public sealed class CultureAndRegionInfoBuilder[<System.Runtime.InteropServices.ComVisible(false)>]
type CultureAndRegionInfoBuilder = classPublic 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 的详细信息,请参阅 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) | 从本地计算机中删除自定义区域性。 |