CultureInfo CultureInfo CultureInfo CultureInfo Class

定義

特定のカルチャ (アンマネージ コードの開発では "ロケール" と呼ばれます) に関する情報を提供します。Provides information about a specific culture (called a locale for unmanaged code development). この情報には、カルチャの名前、表記体系、使用する暦、文字列の並べ替え順序、および日付と数値の書式が含まれます。The information includes the names for the culture, the writing system, the calendar used, the sort order of strings, and formatting for dates and numbers.

public ref class CultureInfo : ICloneable, IFormatProvider
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class CultureInfo : ICloneable, IFormatProvider
type CultureInfo = class
    interface ICloneable
    interface IFormatProvider
Public Class CultureInfo
Implements ICloneable, IFormatProvider
継承
CultureInfoCultureInfoCultureInfoCultureInfo
属性
実装

次の例を作成する方法を示しています、CultureInfoスペイン語 (スペイン) のオブジェクトは、インターナショナル ソート、もうCultureInfoトラディショナル ソートを持つオブジェクト。The following example shows how to create a CultureInfo object for Spanish (Spain) with the international sort and another CultureInfo object with the traditional sort.

using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
   
   // Creates and initializes the CultureInfo which uses the international sort.
   CultureInfo^ myCIintl = gcnew CultureInfo( "es-ES",false );
   
   // Creates and initializes the CultureInfo which uses the traditional sort.
   CultureInfo^ myCItrad = gcnew CultureInfo( 0x040A,false );
   
   // Displays the properties of each culture.
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL" );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl->CompareInfo, myCItrad->CompareInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl->DisplayName, myCItrad->DisplayName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl->EnglishName, myCItrad->EnglishName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl->IsNeutralCulture, myCItrad->IsNeutralCulture );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl->IsReadOnly, myCItrad->IsReadOnly );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "LCID", myCIintl->LCID, myCItrad->LCID );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Name", myCIintl->Name, myCItrad->Name );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl->NativeName, myCItrad->NativeName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "Parent", myCIintl->Parent, myCItrad->Parent );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl->TextInfo, myCItrad->TextInfo );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl->ThreeLetterISOLanguageName, myCItrad->ThreeLetterISOLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl->ThreeLetterWindowsLanguageName, myCItrad->ThreeLetterWindowsLanguageName );
   Console::WriteLine( "{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl->TwoLetterISOLanguageName, myCItrad->TwoLetterISOLanguageName );
   Console::WriteLine();
   
   // Compare two strings using myCIintl -> 
   Console::WriteLine( "Comparing \"llegar\" and \"lugar\"" );
   Console::WriteLine( "   With myCIintl -> CompareInfo -> Compare: {0}", myCIintl->CompareInfo->Compare( "llegar", "lugar" ) );
   Console::WriteLine( "   With myCItrad -> CompareInfo -> Compare: {0}", myCItrad->CompareInfo->Compare( "llegar", "lugar" ) );
}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)          
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False                    
IsReadOnly                     False                                          False                    
LCID                           3082                                           1034                     
Name                           es-ES                                          es-ES                    
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es                       
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
ThreeLetterISOLanguageName     spa                                            spa                      
ThreeLetterWindowsLanguageName ESN                                            ESP                      
TwoLetterISOLanguageName       es                                             es                       

Comparing "llegar" and "lugar"
   With myCIintl -> CompareInfo -> Compare: -1
   With myCItrad -> CompareInfo -> Compare: 1

*/
using System;
using System.Collections;
using System.Globalization;

public class SamplesCultureInfo
{

   public static void Main()
   {

      // Creates and initializes the CultureInfo which uses the international sort.
      CultureInfo myCIintl = new CultureInfo("es-ES", false);

      // Creates and initializes the CultureInfo which uses the traditional sort.
      CultureInfo myCItrad = new CultureInfo(0x040A, false);

      // Displays the properties of each culture.
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL");
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName);
      Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName);
      Console.WriteLine();

      // Compare two strings using myCIintl.
      Console.WriteLine("Comparing \"llegar\" and \"lugar\"");
      Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"));
      Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"));

   }

}

/*
This code produces the following output.

PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
DisplayName                    Spanish (Spain)                                Spanish (Spain)          
EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
IsNeutralCulture               False                                          False                    
IsReadOnly                     False                                          False                    
LCID                           3082                                           1034                     
Name                           es-ES                                          es-ES                    
NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent                         es                                             es                       
TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
ThreeLetterISOLanguageName     spa                                            spa                      
ThreeLetterWindowsLanguageName ESN                                            ESP                      
TwoLetterISOLanguageName       es                                             es                       

Comparing "llegar" and "lugar"
   With myCIintl.CompareInfo.Compare: -1
   With myCItrad.CompareInfo.Compare: 1

*/
Imports System
Imports System.Collections
Imports System.Globalization

Module Module1

    Public Sub Main()

        ' Creates and initializes the CultureInfo which uses the international sort.
        Dim myCIintl As New CultureInfo("es-ES", False)

        ' Creates and initializes the CultureInfo which uses the traditional sort.
        Dim myCItrad As New CultureInfo(&H40A, False)

        ' Displays the properties of each culture.
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL")
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName)
        Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName)
        Console.WriteLine()

        ' Compare two strings using myCIintl.
        Console.WriteLine("Comparing ""llegar"" and ""lugar""")
        Console.WriteLine("   With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"))
        Console.WriteLine("   With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"))

    End Sub 'Main 



'This code produces the following output.
'
'PROPERTY                       INTERNATIONAL                                  TRADITIONAL              
'CompareInfo                    CompareInfo - es-ES                            CompareInfo - es-ES_tradnl
'DisplayName                    Spanish (Spain)                                Spanish (Spain)          
'EnglishName                    Spanish (Spain, International Sort)            Spanish (Spain, Traditional Sort)
'IsNeutralCulture               False                                          False                    
'IsReadOnly                     False                                          False                    
'LCID                           3082                                           1034                     
'Name                           es-ES                                          es-ES                    
'NativeName                     Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
'Parent                         es                                             es                       
'TextInfo                       TextInfo - es-ES                               TextInfo - es-ES_tradnl  
'ThreeLetterISOLanguageName     spa                                            spa                      
'ThreeLetterWindowsLanguageName ESN                                            ESP                      
'TwoLetterISOLanguageName       es                                             es                       
'
'Comparing "llegar" and "lugar"
'   With myCIintl.CompareInfo.Compare: -1
'   With myCItrad.CompareInfo.Compare: 1

End Module

注釈

CultureInfoクラスなど、言語、サブ言語、国/地域、予定表、および特定のカルチャに関連付けられている規則のカルチャに固有の情報を提供します。The CultureInfo class provides culture-specific information, such as the language, sublanguage, country/region, calendar, and conventions associated with a particular culture. このクラスでは、カルチャ固有のインスタンスへのアクセスも提供します、 DateTimeFormatInfoNumberFormatInfoCompareInfo、およびTextInfoオブジェクト。This class also provides access to culture-specific instances of the DateTimeFormatInfo, NumberFormatInfo, CompareInfo, and TextInfo objects. これらのオブジェクトには、大文字小文字の区別、日付や数値の書式設定文字列を比較するなど、カルチャに固有の操作に必要な情報が含まれています。These objects contain the information required for culture-specific operations, such as casing, formatting dates and numbers, and comparing strings. CultureInfoクラスは、使用直接的または間接的に書式設定、解析、またはなど、カルチャに固有のデータを操作するクラスによってStringDateTimeDateTimeOffset、および数値型。The CultureInfo class is used either directly or indirectly by classes that format, parse, or manipulate culture-specific data, such as String, DateTime, DateTimeOffset, and the numeric types.

このセクションの内容:In this section:

カルチャ名と識別子 Culture names and identifiers
インバリアント、中立、および特定のカルチャ Invariant, neutral, and specific cultures
カスタムのカルチャ Custom cultures
動的なカルチャのデータ Dynamic culture data
現在のカルチャと現在の UI カルチャ The current culture and current UI culture
すべてのカルチャを取得します。 Getting all cultures
カルチャとスレッド Culture and threads
カルチャ、およびアプリケーションのドメイン Culture and application domains
カルチャとタスク ベースの非同期操作 Culture and task-based asynchronous operations
CultureInfo オブジェクトのシリアル化 CultureInfo object serialization
コントロール パネルのオーバーライド Control Panel overrides
代替の並べ替え順序 Alternate sort orders
カルチャ、および Windows アプリCulture and Windows apps

カルチャ名と識別子Culture names and identifiers

CultureInfoクラスが RFC 4646 に基づく、カルチャごとに一意の名前を指定します。The CultureInfo class specifies a unique name for each culture, based on RFC 4646. 名前は、言語に関連付けられた ISO 639 2 文字の小文字カルチャ コードと国または地域に関連付けられた ISO 3166 の 2 文字の大文字サブカルチャ コードの組み合わせです。The name is a combination of an ISO 639 two-letter lowercase culture code associated with a language and an ISO 3166 two-letter uppercase subculture code associated with a country or region. 対象とするアプリのさらに、.NET Framework 4.NET Framework 4またはそれ以降を実行している Windows 10 以降、タグがサポートされている有効な bcp-47 の言語に対応するカルチャ名。In addition, for apps that target .NET Framework 4.NET Framework 4 or later and are running under Windows 10 or later, culture names that correspond to valid BCP-47 language tags are supported.

注意

カルチャ名が渡された場合、クラス コンス トラクターまたはメソッドになどCreateSpecificCultureまたはCultureInfo、そのケースは重要ではありません。When a culture name is passed to a class constructor or a method such as CreateSpecificCulture or CultureInfo, its case is not significant.

RFC 4646 に基づくカルチャ名の形式はlanguagecode2>-country/regioncode2ここで、 languagecode2は 2 文字の言語コードですcountry/regioncode2は 2 文字のサブカルチャ コードです。The format for the culture name based on RFC 4646 is languagecode2>-country/regioncode2, where languagecode2 is the two-letter language code and country/regioncode2 is the two-letter subculture code. 例には、英語 (米国) 日本語 (日本) および EN-US、JA-JP が含まれます。Examples include ja-JP for Japanese (Japan) and en-US for English (United States). 2 文字の言語コードが使用できない場合では、ISO 639-2 から派生した 3 文字コードが使用されます。In cases where a two-letter language code is not available, a three-letter code derived from ISO 639-2 is used.

ある一部のカルチャ名も 15924 の ISO に注意してください。Note that some culture names also specify an ISO 15924 script. たとえば、アゼルバイジャン、キリル文字を指定し、Latn ラテン語のスクリプトを指定します。For example, Cyrl specifies the Cyrillic script and Latn specifies the Latin script. スクリプトを含むカルチャ名は、パターンを使用してlanguagecode2-scripttag-country/regioncode2します。A culture name that includes a script uses the pattern languagecode2-scripttag-country/regioncode2. この種類のカルチャ名の例では、ウズベク語 (キリル、ウズベキスタン) に対応する uz です。An example of this type of culture name is uz-Cyrl-UZ for Uzbek (Cyrillic, Uzbekistan). スクリプトを含むカルチャ名がパターンを使用する Windows Vista より前に、の Windows オペレーティング システムでlanguagecode2-country/regioncode2 - scripttag、たとえば、uz UZ-というウズベク語 (キリル、ウズベキスタン) にします。On Windows operating systems before Windows Vista, a culture name that includes a script uses the pattern languagecode2-country/regioncode2-scripttag, for example, uz-UZ-Cyrl for Uzbek (Cyrillic, Uzbekistan).

2 文字の小文字の言語コードのみがニュートラル カルチャを指定します。A neutral culture is specified by only the two-letter lowercase language code. たとえば、fr がフランス語のニュートラル カルチャを指定し、de ドイツ語のニュートラル カルチャを指定します。For example, fr specifies the neutral culture for French, and de specifies the neutral culture for German.

注意

このルールに矛盾する 2 つのカルチャ名があります。There are two culture names that contradict this rule. という名前の Zh-hans、中国語 (簡体字)、および繁体字、Zh-hant、という名前のカルチャとは、ニュートラル カルチャです。The cultures Chinese (Simplified), named zh-Hans, and Chinese (Traditional), named zh-Hant, are neutral cultures. カルチャ名では、現在の標準を表すし、古い名前 ZH-CHS および ZH-CHT を使用するための理由がない場合に使用する必要があります。The culture names represent the current standard and should be used unless you have a reason for using the older names zh-CHS and zh-CHT.

カルチャ識別子は標準国際省略であり、コンポーネントがインストールされているカルチャのいずれかを一意に識別するために必要です。A culture identifier is a standard international numeric abbreviation and has the components necessary to uniquely identify one of the installed cultures. アプリケーションでは、定義済みカルチャ識別子を使用したり、カスタムの識別子を定義することができます。Your application can use predefined culture identifiers or define custom identifiers.

定義済みの特定のカルチャの名前と識別子は、これと他のクラスで使用されて、System.Globalization名前空間。Certain predefined culture names and identifiers are used by this and other classes in the System.Globalization namespace. 詳細なカルチャ情報が表示されます、各国語サポート (NLS) API リファレンスGo Global Developer Center にします。Detailed culture information appears in the National Language Support (NLS) API Reference at the Go Global Developer Center.

カルチャの名前および識別子が、特定のコンピューター上にあるカルチャのサブセットのみを表すことに注意してください。Remember that the culture names and identifiers represent only a subset of cultures that can be found on a particular computer. Windows のバージョンまたは service pack には、使用できるカルチャを変更できます。Windows versions or service packs can change the available cultures. アプリケーションを使用してカスタムのカルチャの追加、CultureAndRegionInfoBuilderクラス。Applications add custom cultures using the CultureAndRegionInfoBuilder class. ユーザーは、Microsoft Locale Builder ツールを使用して、独自のカスタム カルチャを追加します。Users add their own custom cultures using the Microsoft Locale Builder tool. Microsoft Locale Builder を使用してマネージ コードで記述された、CultureAndRegionInfoBuilderクラス。Microsoft Locale Builder is written in managed code using the CultureAndRegionInfoBuilder class.

いくつかの異なる名前のカルチャでは、特に、次のクラス メンバーに関連付けられている名前と密接に関連のとおりです。Several distinct names are closely associated with a culture, notably the names associated with the following class members:

インバリアント、中立、および特定のカルチャInvariant, neutral, and specific cultures

カルチャは、3 つのセットに一般にグループ化されます。 インバリアント カルチャ、ニュートラル カルチャ、および特定のカルチャ。The cultures are generally grouped into three sets: invariant cultures, neutral cultures, and specific cultures.

インバリアント カルチャがカルチャに依存しません。An invariant culture is culture-insensitive. アプリケーションは、空の文字列を使用して名前でインバリアント カルチャを指定します ("") またはその識別子。Your application specifies the invariant culture by name using an empty string ("") or by its identifier. InvariantCulture インバリアント カルチャのインスタンスを定義します。InvariantCulture defines an instance of the invariant culture. 関連付けられているすべての国/地域ではなくが、英語の言語。It is associated with the English language but not with any country/region. ほぼすべてのメソッドで使用される、Globalizationカルチャを必要とする名前空間。It is used in almost any method in the Globalization namespace that requires a culture.

ニュートラル カルチャに関連付けられるカルチャは、国/地域ではなく、言語にします。A neutral culture is a culture that is associated with a language but not with a country/region. 特定のカルチャは、言語と国/地域に関連付けられているカルチャです。A specific culture is a culture that is associated with a language and a country/region. たとえば、fr がフランス語のカルチャのニュートラルな名前および FR-FR が特定のフランス語 (フランス) カルチャの名前。For example, fr is the neutral name for the French culture, and fr-FR is the name of the specific French (France) culture. 簡体字、繁体字もと見なされることのニュートラル カルチャに注意してください。Note that Chinese (Simplified) and Chinese (Traditional) are also considered neutral cultures.

インスタンスを作成、CompareInfoクラスが含まれているデータが任意であるため、ニュートラル カルチャはお勧めできません。Creating an instance of a CompareInfo class for a neutral culture is not recommended because the data it contains is arbitrary. 表示し、データの並べ替え、言語とリージョンの両方を指定します。To display and sort data, specify both the language and region. さらに、NameのプロパティをCompareInfoオブジェクトの作成をニュートラル カルチャ国のみを取得し、領域は含まれません。Additionally, the Name property of a CompareInfo object created for a neutral culture returns only the country and does not include the region.

定義されているカルチャでは、階層を特定のカルチャの親がニュートラル カルチャでは、ニュートラル カルチャの親は、インバリアント カルチャがあります。The defined cultures have a hierarchy in which the parent of a specific culture is a neutral culture and the parent of a neutral culture is the invariant culture. Parentプロパティには、特定のカルチャに関連付けられているカルチャが含まれています。The Parent property contains the neutral culture associated with a specific culture. カスタムのカルチャを定義する必要があります、Parentプロパティがこのパターンに一致します。Custom cultures should define the Parent property in conformance with this pattern.

特定のカルチャのリソースが、オペレーティング システムで利用できない場合は、関連するニュートラル カルチャのリソースが使用されます。If the resources for a specific culture are not available in the operating system, the resources for the associated neutral culture are used. ニュートラル カルチャのリソースが利用できない場合は、メイン アセンブリに埋め込まれたリソースが使用されます。If the resources for the neutral culture are not available, the resources embedded in the main assembly are used. リソース フォールバック プロセスの詳細については、次を参照してください。 Packaging and Deploying Resourcesします。For more information on the resource fallback process, see Packaging and Deploying Resources.

Windows API でのロケールの一覧は、.NET Framework でサポートされているカルチャの一覧とは若干異なります。The list of locales in the Windows API is slightly different from the list of cultures supported by the .NET Framework. Windows との相互運用が必要な場合などの p/invoke メカニズムを通じてアプリケーションする必要がありますが定義されている特定のカルチャ、オペレーティング システムを使用します。If interoperability with Windows is required, for example, through the p/invoke mechanism, the application should use a specific culture that is defined for the operating system. 特定のカルチャの使用と同じであるロケール id で識別される同等の Windows ロケールとの一貫性が確実にLCIDします。Use of the specific culture ensures consistency with the equivalent Windows locale, which is identified with a locale identifier that is the same as LCID.

ADateTimeFormatInfoまたはNumberFormatInfoを特定のカルチャまたはニュートラル カルチャではなく、インバリアント カルチャにのみ作成できます。A DateTimeFormatInfo or a NumberFormatInfo can be created only for the invariant culture or for specific cultures, not for neutral cultures.

場合DateTimeFormatInfo.Calendarは、TaiwanCalendarが、Thread.CurrentCultureに設定されていない、ZH-TW、 DateTimeFormatInfo.NativeCalendarNameDateTimeFormatInfo.GetEraName、およびDateTimeFormatInfo.GetAbbreviatedEraName空の文字列が返されます ("")。If DateTimeFormatInfo.Calendar is the TaiwanCalendar but the Thread.CurrentCulture is not set to zh-TW, then DateTimeFormatInfo.NativeCalendarName, DateTimeFormatInfo.GetEraName, and DateTimeFormatInfo.GetAbbreviatedEraName return an empty string ("").

カスタムのカルチャCustom cultures

だけでなく、Windows オペレーティング システムと .NET Framework でサポートされている定義済みのカルチャは、.NET Framework には、3 種類のカスタム カルチャがサポートされています。In addition to the predefined cultures supported by the Windows operating system and the .NET Framework, the .NET Framework supports three types of custom cultures:

  • Windows または .NET Framework で使用可能なカルチャを補完する新しいカルチャ。New cultures that supplement the cultures available in Windows or the .NET Framework. たとえば、アプリケーションがインストールでした、CultureInfo表します、FJ-FJ (または Fijan (フィジー)) がシステムのカルチャ オブジェクト。For example, an application could install a CultureInfo object that represents the fj-FJ (or Fijan (Fiji)) culture on a system.

  • プロパティが別の Windows と .NET Framework でサポートされる標準的なカルチャのプロパティから置換カルチャ。Replacement cultures whose properties are different from the properties of the standard cultures supported by Windows and the .NET Framework.

  • ユーザーの標準カルチャをオーバーライドします。Standard cultures with user overrides. ユーザーが使用できる、地域と言語アプリケーションコントロール パネルの 既存のカルチャのプロパティの値をカスタマイズします。The user can use the Region and Language application in Control Panel to customize an existing culture's property values.

注意

使用することができます、CultureAndRegionInfoBuilderクラスを定義、保存、および既存のカルチャを置換または補完するカスタムのカルチャを登録します。You can use the CultureAndRegionInfoBuilder class to define, save, and register custom cultures that either supplement or replace existing cultures. CultureAndRegionInfoBuilder.Saveメソッドは、ターゲット システムにカスタム カルチャをインストールするために使用するロケール データのマークアップ言語 (LDML) ファイルを作成します。The CultureAndRegionInfoBuilder.Save method creates a Locale Data Markup Language (LDML) file that can be used to install a custom culture on target systems. 使用に関するステップ バイ ステップ情報のCultureAndRegionInfoBuilder新たに作成するクラスまたは置換カルチャを参照してください、CultureAndRegionInfoBuilderクラスに関するトピック。For step-by step information on using the CultureAndRegionInfoBuilder class to create a new or replacement culture, see the CultureAndRegionInfoBuilder class topic.

.NET Framework では、カスタムのカルチャをサポートするため、カルチャに固有のデータを使用する場合に、次を考慮してください。Because the .NET Framework supports custom cultures, you should consider the following when working with culture-specific data:

  • カスタムのカルチャでは、定義済みのカルチャの範囲を超える値を持つことができます。Custom cultures can have values that exceed the ranges of the predefined cultures. たとえば、一部のカルチャは異常に長い月の名前、予期しない日付または時刻形式、またはその他の異常なデータがあります。For example, some cultures have unusually long month names, unexpected date or time formats, or other unusual data.

  • ユーザー インターフェイスのカルチャに固有のデータを表示する場合は、ユーザーのカスタマイズ内容を遵守する必要があります。たとえば、ユーザーは、24 時間制または yyyyMMdd という日付形式にする可能性があります。When you display culture-specific data in the user interface, you should respect the user's customizations; for example, the user might want a 24-hour clock or a yyyyMMdd date format.

  • カスタムのカルチャが既定値を上書きすることに注意してください。Remember that custom cultures override default values. そのため、安定しているカルチャのデータを考慮することはできません。Therefore, you cannot consider culture data to be stable. 国名、数値と日付の形式、およびスペルは、今後変更可能性があります。Country names, number and date formats, and spellings may change in the future. 日付と時刻の解析関数に渡される日付と時刻の文字列などのカルチャに依存するデータをシリアル化する場合は、インバリアント カルチャまたは特定を使用する必要があります。If you want to serialize culture-sensitive data such as date and time strings to be passed to the date and time parsing functions, you should use the invariant culture or a specific .

CultureTypesシステムにインストールされているカスタムのカルチャのプロパティの値が含まれています、System.Globalization.CultureTypesフラグ、およびカスタムのカルチャが割り当てられている、LCIDプロパティ値のLOCALE_CUSTOM_UNSPECIFIED(0x1000、または 4096)。The CultureTypes property value of custom cultures installed on a system includes the System.Globalization.CultureTypes flag, and custom cultures are assigned an LCID property value of LOCALE_CUSTOM_UNSPECIFIED (0x1000, or 4096). Windows 10 以降、この値も割り当てられているカルチャの完全なデータがないシステム定義のカルチャに注意してください。Note that, starting with Windows 10, this value is also assigned to system-defined cultures that lack complete cultural data.

動的なカルチャのデータDynamic culture data

を除き、インバリアント カルチャのデータは動的です。Except for the invariant culture, culture data is dynamic. これは、定義済みのカルチャにも当てはまります。This is true even for the predefined cultures. たとえば、国や地域の通貨が新しく導入、その単語のスペルを変更または、使用する暦を変更し、カルチャの定義はこれを追跡するために変更します。For example, countries or regions adopt new currencies, change their spellings of words, or change their preferred calendar, and culture definitions change to track this. カスタム カルチャが、予告なく変更される可能性があり、置換のカスタム カルチャによって、特定のカルチャをオーバーライドする可能性があります。Custom cultures are subject to change without notice, and any specific culture might be overridden by a custom replacement culture. また、以下のように、個々 のユーザーはカルチャ設定をオーバーライドできます。Also, as discussed below, an individual user can override cultural preferences. アプリケーションでは、実行時に常にカルチャのデータを取得する必要があります。Applications should always obtain culture data at run time.

注意事項

データを保存するときに、アプリケーションは、インバリアント カルチャ、バイナリ形式、または特定のカルチャに依存しない形式を使用する必要があります。When saving data, your application should use the invariant culture, a binary format, or a specific culture-independent format. インバリアント カルチャ以外の特定のカルチャに関連付けられている現在の値に従って保存されたデータは、読み取り不可能になる可能性があります。 またはそのカルチャが変更された場合意味的に変更する可能性があります。Data saved according to the current values associated with a particular culture, other than the invariant culture, might become unreadable or might change in meaning if that culture changes.

現在のカルチャと現在の UI カルチャThe current culture and current UI culture

すべてのスレッド、.NET Framework アプリケーションには、現在のカルチャと現在の UI カルチャをが。Every thread in a .NET Framework application has a current culture and a current UI culture. 現在のカルチャでは、日付、時刻、数字、および通貨の値、テキスト、大文字と小文字の表記規則、および文字列の比較方法の並べ替え順序の書式指定規則を決定します。The current culture determines the formatting conventions for dates, times, numbers, and currency values, the sort order of text, casing conventions, and the ways in which strings are compared. 現在の UI カルチャを使用して、実行時にカルチャ固有のリソースを取得します。The current UI culture is used to retrieve culture-specific resources at runtime.

注意

スレッドごとに、現在と現在の UI カルチャを決定する方法については、次を参照してください。、カルチャとスレッドセクション。For information on how the current and current UI culture is determined on a per-thread basis, see the Culture and threads section. スレッドの現在と現在の UI カルチャを決定する方法については、新しいアプリケーション ドメインとアプリケーション ドメインの境界を越えてスレッドの実行を参照してください、カルチャとアプリケーション ドメインセクション。For information on how the current and current UI culture is determined on threads executing in a new application domain, and on threads that cross application domain boundaries, see the Culture and application domains section. タスク ベースの非同期操作を実行するスレッドの現在と現在を決定する方法については、次を参照してください。、カルチャとタスク ベースの非同期操作セクション。For information on how the current and current is determined on threads performing task-based asynchronous operations, see the Culture and task-based asynchronous operations section.

詳細については、現在のカルチャを参照してください、CultureInfo.CurrentCultureプロパティのトピックです。For more detailed information on the current culture, see the CultureInfo.CurrentCulture property topic. 詳細については、現在の UI カルチャを参照してください、CultureInfo.CurrentUICultureプロパティのトピックです。For more detailed information on the current UI culture, see the CultureInfo.CurrentUICulture property topic.

現在と現在の UI カルチャを取得します。Retrieving the current and current UI cultures

取得することができます、 CultureInfo 2 つの方法のいずれかで、現在のカルチャを表すオブジェクト。You can get a CultureInfo object that represents the current culture in either of two ways:

次の例では、両方のプロパティ値を取得を比較を表示していることと等しい場合は、現在のカルチャの名前を表示します。The following example retrieves both property values, compares them to show that they are equal, and displays the name of the current culture.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      CultureInfo culture1 = CultureInfo.CurrentCulture;
      CultureInfo culture2 = Thread.CurrentThread.CurrentCulture;
      Console.WriteLine("The current culture is {0}", culture1.Name);
      Console.WriteLine("The two CultureInfo objects are equal: {0}",
                        culture1 == culture2);
   }
}
// The example displays output like the following:
//     The current culture is en-US
//     The two CultureInfo objects are equal: True
Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Dim culture1 As CultureInfo = CultureInfo.CurrentCulture
      Dim culture2 As CultureInfo = Thread.CurrentThread.CurrentCulture
      Console.WriteLine("The current culture is {0}", culture1.Name)
      Console.WriteLine("The two CultureInfo objects are equal: {0}",
                        culture1.Equals(culture2))
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The two CultureInfo objects are equal: True

取得できます、 CultureInfo 2 つの方法のいずれかで現在の UI カルチャを表すオブジェクト。You can get a CultureInfo object that represents the current UI culture in either of two ways:

次の例では、両方のプロパティ値を取得を表示していることと等しい場合は、現在の UI カルチャの名前を表示することを比較します。The following example retrieves both property values, compares them to show that they are equal, and displays the name of the current UI culture.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      CultureInfo uiCulture1 = CultureInfo.CurrentUICulture;
      CultureInfo uiCulture2 = Thread.CurrentThread.CurrentUICulture;
      Console.WriteLine("The current UI culture is {0}", uiCulture1.Name);
      Console.WriteLine("The two CultureInfo objects are equal: {0}",
                        uiCulture1 == uiCulture2);
   }
}
// The example displays output like the following:
//     The current UI culture is en-US
//     The two CultureInfo objects are equal: True
Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      Dim uiCulture1 As CultureInfo = CultureInfo.CurrentUICulture
      Dim uiCulture2 As CultureInfo = Thread.CurrentThread.CurrentUICulture
      Console.WriteLine("The current UI culture is {0}", uiCulture1.Name)
      Console.WriteLine("The two CultureInfo objects are equal: {0}",
                        uiCulture1.Equals(uiCulture2))
   End Sub
End Module
' The example displays output like the following:
'     The current UI culture is en-US
'     The two CultureInfo objects are equal: True

現在と現在の UI カルチャの設定Setting the current and current UI cultures

カルチャとスレッドの UI カルチャを変更するには、次の操作を行います。To change the culture and UI culture of a thread, do the following:

  1. インスタンスを作成、CultureInfo呼び出すことによって、そのカルチャを表すオブジェクトをCultureInfoクラスのコンス トラクターとカルチャの名前を渡します。Instantiate a CultureInfo object that represents that culture by calling a CultureInfo class constructor and passing it the name of the culture. CultureInfo(String)コンス トラクターをインスタンス化、CultureInfoユーザーを表すオブジェクトでは、新しいカルチャが Windows の現在のカルチャと同じである場合よりも優先されます。The CultureInfo(String) constructor instantiates a CultureInfo object that reflects user overrides if the new culture is the same as the current Windows culture. CultureInfo(String, Boolean)コンス トラクターを使用すると、指定するかどうか新しくインスタンス化されたCultureInfoオブジェクトは、ユーザーが新しいカルチャが Windows の現在のカルチャと同じである場合に上書きが反映されます。The CultureInfo(String, Boolean) constructor allows you to specify whether the newly instantiated CultureInfo object reflects user overrides if the new culture is the same as the current Windows culture.

  2. 割り当てる、CultureInfoオブジェクトをThread.CurrentCultureまたはThread.CurrentUICultureプロパティ。Assign the CultureInfo object to the Thread.CurrentCulture or Thread.CurrentUICulture property. さらに、バージョンのデスクトップの .NET Framework 4.6 以降を実行して、アプリに割り当てることも、CultureInfoオブジェクトをCultureInfo.CurrentCultureまたはCultureInfo.CurrentUICultureプロパティ。In addition, for apps running on the version 4.6 or later of the desktop .NET Framework, you can also assign the CultureInfo object to the CultureInfo.CurrentCulture or CultureInfo.CurrentUICulture property.

次の例では、現在のカルチャを取得します。The following example retrieves the current culture. 、フランス語 (フランス) カルチャ以外のものである場合、現在のカルチャをフランス語 (フランス) に変更します。If it is anything other than the French (France) culture, it changes the current culture to French (France). それ以外の場合、現在のカルチャをフランス語 (ルクセンブルク) に変わります。Otherwise, it changes the current culture to French (Luxembourg).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo current = CultureInfo.CurrentCulture;
      Console.WriteLine("The current culture is {0}", current.Name);
      CultureInfo newCulture;
      if (current.Name.Equals("fr-FR"))
         newCulture = new CultureInfo("fr-LU");
      else   
         newCulture = new CultureInfo("fr-FR");
      
      CultureInfo.CurrentCulture = newCulture;
      Console.WriteLine("The current culture is now {0}", 
                        CultureInfo.CurrentCulture.Name);   
   }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else   
         newCulture = new CultureInfo("fr-FR")
      End If
      
      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}", 
                        CultureInfo.CurrentCulture.Name)   
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

次の例では、現在のカルチャを取得します。The following example retrieves the current culture. 以外のものである場合、スロベニア語 (スロベニア) カルチャ語 (スロベニア) に、現在のカルチャを変更します。If it is anything other the Slovenian (Slovenia) culture, it changes the current culture to Slovenian (Slovenia). それ以外の場合、現在のカルチャをクロアチア語 (クロアチア) に変わります。Otherwise, it changes the current culture to Croatian (Croatia).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo current = CultureInfo.CurrentUICulture;
      Console.WriteLine("The current UI culture is {0}", current.Name);
      CultureInfo newUICulture;
      if (current.Name.Equals("sl-SI"))
         newUICulture = new CultureInfo("hr-HR");
      else   
         newUICulture = new CultureInfo("sl-SI");
      
      CultureInfo.CurrentUICulture = newUICulture;
      Console.WriteLine("The current UI culture is now {0}", 
                        CultureInfo.CurrentUICulture.Name);   
   }
}
// The example displays output like the following:
//     The current UI culture is en-US
//     The current UI culture is now sl-SI
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentUICulture
      Console.WriteLine("The current UI culture is {0}", current.Name)
      Dim newUICulture As CultureInfo
      If current.Name.Equals("sl-SI") Then
         newUICulture = New CultureInfo("hr-HR")
      Else   
         newUICulture = new CultureInfo("sl-SI")
      End If
      
      CultureInfo.CurrentUICulture = newUICulture
      Console.WriteLine("The current UI culture is now {0}", 
                        CultureInfo.CurrentUICulture.Name)   
   End Sub
End Module
' The example displays output like the following:
'     The current UI culture is en-US
'     The current UI culture is now sl-SI

すべてのカルチャを取得します。Getting all cultures

または、ローカル コンピューター上で使用可能なすべてのカルチャのカルチャの配列特定カテゴリを取得するには呼び出すことによって、GetCulturesメソッド。You can retrieve an array specific categories of cultures or of all the cultures available on the local computer by calling the GetCultures method. たとえば、単独または組み合わせでは、カスタム カルチャ、特定のカルチャまたはニュートラル カルチャを取得できます。For example, you can retrieve custom cultures, specific cultures, or neutral cultures either alone or in combination.

次の例では、GetCulturesメソッドを 2 回、1 つ目のSystem.Globalization.CultureTypes列挙型のメンバーをすべてのカスタム カルチャを取得し、使用して、System.Globalization.CultureTypes列挙型のメンバーをすべて置換カルチャを取得します。The following example calls the GetCultures method twice, first with the System.Globalization.CultureTypes enumeration member to retrieve all custom cultures, and then with the System.Globalization.CultureTypes enumeration member to retrieve all replacement cultures.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Get all custom cultures.
      CultureInfo[] custom = CultureInfo.GetCultures(CultureTypes.UserCustomCulture);
      if (custom.Length == 0) { 
         Console.WriteLine("There are no user-defined custom cultures.");
      }
      else {
         Console.WriteLine("Custom cultures:");
         foreach (var culture in custom) 
            Console.WriteLine("   {0} -- {1}", culture.Name, culture.DisplayName);    
      }
      Console.WriteLine();
      
      // Get all replacement cultures.
      CultureInfo[] replacements = CultureInfo.GetCultures(CultureTypes.ReplacementCultures);
      if (replacements.Length == 0) { 
         Console.WriteLine("There are no replacement cultures.");
      }                                             
      else {
         Console.WriteLine("Replacement cultures:");
         foreach (var culture in replacements) 
            Console.WriteLine("   {0} -- {1}", culture.Name, culture.DisplayName);    
      }
      Console.WriteLine();
   }
}
// The example displays output like the following:
//     Custom cultures:
//        x-en-US-sample -- English (United States)
//        fj-FJ -- Boumaa Fijian (Viti)
//     
//     There are no replacement cultures.
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Get all custom cultures.
      Dim custom() As CultureInfo = CultureInfo.GetCultures(CultureTypes.UserCustomCulture)
      If custom.Length = 0 Then 
         Console.WriteLine("There are no user-defined custom cultures.")
      Else
         Console.WriteLine("Custom cultures:")
         For Each culture In custom 
            Console.WriteLine("   {0} -- {1}", culture.Name, culture.DisplayName)
         Next       
      End If
      Console.WriteLine()
      
      ' Get all replacement cultures.
      Dim replacements() As CultureInfo = CultureInfo.GetCultures(CultureTypes.ReplacementCultures)
      If replacements.Length = 0 Then 
         Console.WriteLine("There are no replacement cultures.")
      Else 
         Console.WriteLine("Replacement cultures:")
         For Each culture in replacements 
            Console.WriteLine("   {0} -- {1}", culture.Name, culture.DisplayName)    
         Next
      End If
      Console.WriteLine()
   End Sub
End Module
' The example displays output like the following:
'     Custom cultures:
'        x-en-US-sample -- English (United States)
'        fj-FJ -- Boumaa Fijian (Viti)
'     
'     There are no replacement cultures.

カルチャとスレッドCulture and threads

新しいアプリケーションのスレッドが開始されると、その現在のカルチャおよび UI カルチャの現在と定義されますは現在のシステム カルチャによって、現在のスレッド カルチャではありません。When a new application thread is started, its current culture and current UI culture are defined by the current system culture, and not by the current thread culture. この違いを次の例に示します。The following example illustrates the difference. 現在のカルチャと、アプリケーションのスレッドの現在の UI カルチャをフランス語 (フランス) カルチャ (FR-FR) に設定します。It sets the current culture and current UI culture of an application thread to the French (France) culture (fr-FR). 既に現在のカルチャが FR-FR の場合は、例は、英語 (米国) カルチャ (EN-US) に設定します。If the current culture is already fr-FR, the example sets it to the English (United States) culture (en-US). 通貨値として 3 つのランダムな数値を表示し、し、さらに、通貨値として 3 つのよりランダムな数値を表示する新しいスレッドを作成します。It displays three random numbers as currency values and then creates a new thread, which, in turn, displays three more random numbers as currency values. 例の出力として、新しいスレッドで表示される通貨の値は反映メイン アプリケーション スレッドからの出力とは異なり、フランス語 (フランス) カルチャの書式指定規則。But as the output from the example shows, the currency values displayed by the new thread do not reflect the formatting conventions of the French (France) culture, unlike the output from the main application thread.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   static Random rnd = new Random();
   
   public static void Main()
   {
      if (Thread.CurrentThread.CurrentCulture.Name != "fr-FR") {
         // If current culture is not fr-FR, set culture to fr-FR.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR");
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
      }
      else {
         // Set culture to en-US.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("en-US");
      }
      ThreadProc();
          
      Thread worker = new Thread(ThreadProc);
      worker.Name = "WorkerThread";
      worker.Start();
   }
   
   private static void DisplayThreadInfo()
   {
      Console.WriteLine("\nCurrent Thread Name: '{0}'", 
                        Thread.CurrentThread.Name);
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name);                        
   }
   
   private static void DisplayValues()
   {
      // Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:");
      for (int ctr = 0; ctr <= 3; ctr++)
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10);                        
   }
   
   private static void ThreadProc()
   {
      DisplayThreadInfo();
      DisplayValues();
   }
}
// The example displays output similar to the following:
//       Current Thread Name: ''
//       Current Thread Culture/UI Culture: fr-FR/fr-FR
//       Some currency values:
//          8,11 €
//          1,48 €
//          8,99 €
//          9,04 €
//       
//       Current Thread Name: 'WorkerThread'
//       Current Thread Culture/UI Culture: en-US/en-US
//       Some currency values:
//          $6.72
//          $6.35
//          $2.90
//          $7.72
Imports System.Globalization
Imports System.Threading

Module Example
   Dim rnd As New Random()
   
   Public Sub Main()
      If Thread.CurrentThread.CurrentCulture.Name <> "fr-FR" Then
         ' If current culture is not fr-FR, set culture to fr-FR.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR")
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Else
         ' Set culture to en-US.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US")
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("en-US")
      End If
      ThreadProc()
          
       Dim worker As New Thread(AddressOf ThreadProc)
       worker.Name = "WorkerThread"
       worker.Start()
   End Sub
   
   Private Sub DisplayThreadInfo()
      Console.WriteLine()
      Console.WriteLine("Current Thread Name: '{0}'", 
                        Thread.CurrentThread.Name)
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name)                        
   End Sub
   
   Private Sub DisplayValues()
      ' Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:")
      For ctr As Integer = 0 To 3
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10)                        
      Next
   End Sub
   
   Private Sub ThreadProc()
      DisplayThreadInfo()
      DisplayValues()
   End Sub
End Module
' The example displays output similar to the following:
'       Current Thread Name: ''
'       Current Thread Culture/UI Culture: fr-FR/fr-FR
'       Some currency values:
'          8,11 €
'          1,48 €
'          8,99 €
'          9,04 €
'       
'       Current Thread Name: 'WorkerThread'
'       Current Thread Culture/UI Culture: en-US/en-US
'       Some currency values:
'          $6.72
'          $6.35
'          $2.90
'          $7.72

前に .NET Framework のバージョンでは、 .NET Framework 4.5.NET Framework 4.5、最もメイン アプリケーション スレッドが他のすべてのワーカー スレッドと同じカルチャを共有することを確認する一般的な方法は、アプリケーション全体のカルチャの名前を渡す、またはCultureInfoオブジェクトをアプリケーション全体のカルチャを表す、System.Threading.ParameterizedThreadStartを委任します。In versions of the .NET Framework before the .NET Framework 4.5.NET Framework 4.5, the most common way to ensure that the main application thread shares the same culture with all other worker threads is to pass either the name of the application-wide culture or a CultureInfo object that represents the application-wide culture to a System.Threading.ParameterizedThreadStart delegate. 次の例では、このアプローチを使用して、2 つのスレッドで表示される通貨の値が同じカルチャの書式指定規則を反映することを確認します。The following example uses this approach to ensure that the currency values displayed by two threads reflect the formatting conventions of the same culture.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   static Random rnd = new Random();
   
   public static void Main()
   {
      if (Thread.CurrentThread.CurrentCulture.Name != "fr-FR") {
         // If current culture is not fr-FR, set culture to fr-FR.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR");
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
      }   
      else {
         // Set culture to en-US.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("en-US");
      }
      DisplayThreadInfo();
      DisplayValues();
          
       Thread worker = new Thread(Example.ThreadProc);
       worker.Name = "WorkerThread";
       worker.Start(Thread.CurrentThread.CurrentCulture);
   }
   
   private static void DisplayThreadInfo()
   {
      Console.WriteLine("\nCurrent Thread Name: '{0}'", 
                        Thread.CurrentThread.Name);
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name);                        
   }
   
   private static void DisplayValues()
   {
      // Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:");
      for (int ctr = 0; ctr <= 3; ctr++)
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10);                        
   }
   
   private static void ThreadProc(Object obj) 
   {
      Thread.CurrentThread.CurrentCulture = (CultureInfo) obj;
      Thread.CurrentThread.CurrentUICulture = (CultureInfo) obj;
      DisplayThreadInfo();
      DisplayValues();
   }
}
// The example displays output similar to the following:
//       Current Thread Name: ''
//       Current Thread Culture/UI Culture: fr-FR/fr-FR
//       Some currency values:
//          6,83 €
//          3,47 €
//          6,07 €
//          1,70 €
//       
//       Current Thread Name: 'WorkerThread'
//       Current Thread Culture/UI Culture: fr-FR/fr-FR
//       Some currency values:
//          9,54 €
//          9,50 €
//          0,58 €
//          6,91 €
Imports System.Globalization
Imports System.Threading

Module Example
   Dim rnd As New Random()
   
   Public Sub Main()
      If Thread.CurrentThread.CurrentCulture.Name <> "fr-FR" Then
         ' If current culture is not fr-FR, set culture to fr-FR.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR")
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Else
         ' Set culture to en-US.
         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US")
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("en-US")
      End If
      DisplayThreadInfo()
      DisplayValues()
          
       Dim worker As New Thread(AddressOf ThreadProc)
       worker.Name = "WorkerThread"
       worker.Start(Thread.CurrentThread.CurrentCulture)
   End Sub
   
   Private Sub DisplayThreadInfo()
      Console.WriteLine()
      Console.WriteLine("Current Thread Name: '{0}'", 
                        Thread.CurrentThread.Name)
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name)                        
   End Sub
   
   Private Sub DisplayValues()
      ' Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:")
      For ctr As Integer = 0 To 3
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10)                        
      Next
   End Sub
   
   Private Sub ThreadProc(obj As Object)
      Thread.CurrentThread.CurrentCulture = CType(obj, CultureInfo)
      Thread.CurrentThread.CurrentUICulture = CType(obj, CultureInfo)
      DisplayThreadInfo()
      DisplayValues()
   End Sub
End Module
' The example displays output similar to the following:
'       Current Thread Name: ''
'       Current Thread Culture/UI Culture: fr-FR/fr-FR
'       Some currency values:
'          6,83 €
'          3,47 €
'          6,07 €
'          1,70 €
'       
'       Current Thread Name: 'WorkerThread'
'       Current Thread Culture/UI Culture: fr-FR/fr-FR
'       Some currency values:
'          9,54 €
'          9,50 €
'          0,58 €
'          6,91 €

設定できるカルチャおよび UI カルチャのスレッドのプールのスレッドと同様の方法を呼び出して、ThreadPool.QueueUserWorkItem(WaitCallback, Object)メソッド。You can set the culture and UI culture of thread pool threads in a similar manner by calling the ThreadPool.QueueUserWorkItem(WaitCallback, Object) method.

以降では、.NET Framework 4.5.NET Framework 4.5で設定できるカルチャおよび UI カルチャのすべてのスレッドのアプリケーション ドメインを割り当てることで直接、CultureInfoそのカルチャを表すオブジェクト、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureプロパティ。Starting with the .NET Framework 4.5.NET Framework 4.5, you can set the culture and UI culture of all threads in an application domain more directly by assigning a CultureInfo object that represents that culture to the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties. 次の例では、これらのプロパティを使用して、既定のアプリケーション ドメインのすべてのスレッドが同じカルチャを共有することを確認します。The following example uses these properties to ensure that all threads in the default application domain share the same culture.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   static Random rnd = new Random();
   
   public static void Main()
   {
      if (Thread.CurrentThread.CurrentCulture.Name != "fr-FR") {
         // If current culture is not fr-FR, set culture to fr-FR.
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR");
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR");
      }   
      else {
         // Set culture to en-US.
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture("en-US");
      }
      ThreadProc();
          
      Thread worker = new Thread(Example.ThreadProc);
      worker.Name = "WorkerThread";
      worker.Start();
   }
   
   private static void DisplayThreadInfo()
   {
      Console.WriteLine("\nCurrent Thread Name: '{0}'", 
                        Thread.CurrentThread.Name);
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name);                        
   }
   
   private static void DisplayValues()
   {
      // Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:");
      for (int ctr = 0; ctr <= 3; ctr++)
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10);                        
   }
   
   private static void ThreadProc() 
   {
      DisplayThreadInfo();
      DisplayValues();
   }
}
// The example displays output similar to the following:
//       Current Thread Name: ''
//       Current Thread Culture/UI Culture: fr-FR/fr-FR
//       Some currency values:
//          6,83 €
//          3,47 €
//          6,07 €
//          1,70 €
//       
//       Current Thread Name: 'WorkerThread'
//       Current Thread Culture/UI Culture: fr-FR/fr-FR
//       Some currency values:
//          9,54 €
//          9,50 €
//          0,58 €
//          6,91 €
Imports System.Globalization
Imports System.Threading

Module Example
   Dim rnd As New Random()
   
   Public Sub Main()
      If Thread.CurrentThread.CurrentCulture.Name <> "fr-FR" Then
         ' If current culture is not fr-FR, set culture to fr-FR.
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture("fr-FR")
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture("fr-FR")
      Else
         ' Set culture to en-US.
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture("en-US")
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture("en-US")
      End If
      ThreadProc()

       Dim worker As New Thread(AddressOf ThreadProc)
       worker.Name = "WorkerThread"
       worker.Start()
   End Sub
   
   Private Sub DisplayThreadInfo()
      Console.WriteLine()
      Console.WriteLine("Current Thread Name: '{0}'", 
                        Thread.CurrentThread.Name)
      Console.WriteLine("Current Thread Culture/UI Culture: {0}/{1}", 
                        Thread.CurrentThread.CurrentCulture.Name,
                        Thread.CurrentThread.CurrentUICulture.Name)                        
   End Sub
   
   Private Sub DisplayValues()
      ' Create new thread and display three random numbers.
      Console.WriteLine("Some currency values:")
      For ctr As Integer = 0 To 3
         Console.WriteLine("   {0:C2}", rnd.NextDouble() * 10)                        
      Next
   End Sub
   
   Private Sub ThreadProc()
      DisplayThreadInfo()
      DisplayValues()
   End Sub
End Module
' The example displays output similar to the following:
'       Current Thread Name: ''
'       Current Thread Culture/UI Culture: fr-FR/fr-FR
'       Some currency values:
'          6,83 €
'          3,47 €
'          6,07 €
'          1,70 €
'       
'       Current Thread Name: 'WorkerThread'
'       Current Thread Culture/UI Culture: fr-FR/fr-FR
'       Some currency values:
'          9,54 €
'          9,50 €
'          0,58 €
'          6,91 €

警告

ただし、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureプロパティは、静的メンバーを既定のカルチャとは、これらのプロパティ値の設定時に現在あるアプリケーション ドメインに対してのみの既定 UI カルチャを定義します。Although the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties are static members, they define the default culture and default UI culture only for the application domain that is current at the time these property values are set. 詳細については、次のセクションを参照してください。カルチャとアプリケーション ドメインします。For more information, see the next section, Culture and application domains.

値を割り当てるときに、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureプロパティでは、カルチャおよび UI カルチャのアプリケーション ドメインのスレッドが明示的に割り当てられていない場合、カルチャも変更します。When you assign values to the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties, the culture and UI culture of the threads in the application domain also change if they have not explicitly been assigned a culture. ただし、これらのスレッドでは、現在のアプリケーション ドメインで、実行中にのみ、新しいカルチャ設定が反映されます。However, these threads reflect the new culture settings only while they execute in the current application domain. これらのスレッドは、別のアプリケーション ドメインで実行して、そのアプリケーション ドメインに対して定義されている既定のカルチャのカルチャになります。If these threads execute in another application domain, their culture becomes the default culture defined for that application domain. 常に、メイン アプリケーション スレッドのカルチャを設定して、依存しないをお勧めこの結果、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureプロパティを変更します。As a result, we recommend that you always set the culture of the main application thread, and not rely on the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties to change it.

カルチャ、およびアプリケーションのドメインCulture and application domains

DefaultThreadCurrentCulture DefaultThreadCurrentUICulture静的プロパティのみがプロパティの値を設定または取得時に、現在のアプリケーション ドメインの既定のカルチャを明示的に定義です。DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture are static properties that explicitly define a default culture only for the application domain that is current when the property value is set or retrieved. 次の例は、フランス語 (フランス)、既定のアプリケーション ドメインで、既定のカルチャと UI カルチャの既定値に設定しを使用して、AppDomainSetupクラスおよびAppDomainInitializerデリゲートを新しいアプリケーション ドメインで、既定のカルチャおよび UI カルチャを設定するにはロシア語 (ロシア)。The following example sets the default culture and default UI culture in the default application domain to French (France), and then uses the AppDomainSetup class and the AppDomainInitializer delegate to set the default culture and UI culture in a new application domain to Russian (Russia). 次に、1 つのスレッドはアプリケーション ドメインごとに 2 つのメソッドを実行します。A single thread then executes two methods in each application domain. スレッドのカルチャおよび UI カルチャが明示的に設定されていないことです。 注意してください。既定のカルチャおよび UI カルチャのスレッドを実行しているアプリケーション ドメインから派生しています。Note that the thread's culture and UI culture are not explicitly set; they are derived from the default culture and UI culture of the application domain in which the thread is executing. なお、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureプロパティが既定値を返すCultureInfoメソッドの呼び出しが行われたときに、現在のアプリケーション ドメインの値。Note also that the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties return the default CultureInfo values of the application domain that is current when the method call is made.

using System;
using System.Globalization;
using System.Reflection;
using System.Threading;

public class Example
{
   public static void Main()
   {
      // Set the default culture and display the current date in the current application domain.
      Info info1 = new Info();
      SetAppDomainCultures("fr-FR");
      
      // Create a second application domain.
      AppDomainSetup setup = new AppDomainSetup();
      setup.AppDomainInitializer = SetAppDomainCultures;
      setup.AppDomainInitializerArguments = new string[] { "ru-RU" };
      AppDomain domain = AppDomain.CreateDomain("Domain2", null, setup);
      // Create an Info object in the new application domain.
      Info info2 = (Info) domain.CreateInstanceAndUnwrap(typeof(Example).Assembly.FullName, 
                                                         "Info"); 

      // Execute methods in the two application domains.
      info2.DisplayDate();
      info2.DisplayCultures();
      
      info1.DisplayDate();
      info1.DisplayCultures();            
   }

   public static void SetAppDomainCultures(string[] names)
   {
      SetAppDomainCultures(names[0]);
   }
   
   public static void SetAppDomainCultures(string name)
   {
       try {
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture(name);
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture(name);
      }
      // If an exception occurs, we'll just fall back to the system default.
      catch (CultureNotFoundException) {
         return;
      }   
      catch (ArgumentException) {
         return;
      } 
   }
}

public class Info : MarshalByRefObject
{
   public void DisplayDate()
   {
      Console.WriteLine("Today is {0:D}", DateTime.Now);
   }
   
   public void DisplayCultures()
   {
      Console.WriteLine("Application domain is {0}", AppDomain.CurrentDomain.Id);
      Console.WriteLine("Default Culture: {0}", CultureInfo.DefaultThreadCurrentCulture);
      Console.WriteLine("Default UI Culture: {0}", CultureInfo.DefaultThreadCurrentUICulture);
   }
}
// The example displays the following output:
//       Today is 14 октября 2011 г.
//       Application domain is 2
//       Default Culture: ru-RU
//       Default UI Culture: ru-RU
//       Today is vendredi 14 octobre 2011
//       Application domain is 1
//       Default Culture: fr-FR
//       Default UI Culture: fr-FR
Imports System.Globalization
Imports System.Reflection
Imports System.Threading

Module Example
   Public Sub Main()
      ' Set the default culture and display the current date in the current application domain.
      Dim info1 As New Info()
      SetAppDomainCultures("fr-FR")
      
      ' Create a second application domain.
      Dim setup As New AppDomainSetup()
      setup.AppDomainInitializer = AddressOf SetAppDomainCultures
      setup.AppDomainInitializerArguments = { "ru-RU" }
      Dim domain As AppDomain = AppDomain.CreateDomain("Domain2", Nothing, setup)
      ' Create an Info object in the new application domain.
      Dim info2 As Info = CType(domain.CreateInstanceAndUnwrap(GetType(Example).Assembly.FullName, 
                                                               "Info"), Info) 

      ' Execute methods in the two application domains.
      info2.DisplayDate()
      info2.DisplayCultures()
      
      info1.DisplayDate()
      info1.DisplayCultures()            
   End Sub
   
   Public Sub SetAppDomainCultures(names() As String)
      SetAppDomainCultures(names(0))
   End Sub
   
   Public Sub SetAppDomainCultures(name As String)
       Try
         CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CreateSpecificCulture(name)
         CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.CreateSpecificCulture(name)
      ' If an exception occurs, we'll just fall back to the system default.
      Catch e As CultureNotFoundException
         Return
      Catch e As ArgumentException
         Return
      End Try      
   End Sub
End Module

Public Class Info : Inherits MarshalByRefObject
   Public Sub DisplayDate()
      Console.WriteLine("Today is {0:D}", Date.Now)
   End Sub
   
   Public Sub DisplayCultures()
      Console.WriteLine("Application domain is {0}", AppDomain.CurrentDomain.Id)
      Console.WriteLine("Default Culture: {0}", CultureInfo.DefaultThreadCurrentCulture)
      Console.WriteLine("Default UI Culture: {0}", CultureInfo.DefaultThreadCurrentUICulture)
   End Sub
End Class
' The example displays the following output:
'       Today is 14 октября 2011 г.
'       Application domain is 2
'       Default Culture: ru-RU
'       Default UI Culture: ru-RU
'       Today is vendredi 14 octobre 2011
'       Application domain is 1
'       Default Culture: fr-FR
'       Default UI Culture: fr-FR

カルチャとアプリケーション ドメインの詳細については、トピックの「アプリケーション ドメインとスレッド」セクションを参照してください。For more information about cultures and application domains, see the "Application Domains and Threads" section in the topic.

カルチャとタスク ベースの非同期操作Culture and task-based asynchronous operations

タスクベースの非同期プログラミング パターン使用TaskTask<TResult>プールのスレッドのスレッドでデリゲートを非同期的に実行するオブジェクト。The task-based asynchronous programming pattern uses Task and Task<TResult> objects to asynchronously execute delegates on thread pool threads. 特定のタスクが実行されている特定のスレッドは、事前にわからないが、実行時のみに決定します。The specific thread on which a particular task runs is not known in advance, but is determined only at runtime.

対象とするアプリ、.NET Framework 4.6.NET Framework 4.6または以降のバージョン、カルチャ、非同期操作のコンテキストの一部であります。For apps that target the .NET Framework 4.6.NET Framework 4.6 or later versions, culture is part of an asynchronous operation's context. つまり、以降でアプリを対象とする、 .NET Framework 4.6.NET Framework 4.6、既定で非同期操作の値の継承、CurrentCultureCurrentUICultureは起動元のスレッドのプロパティ。In other words, starting with apps that target the .NET Framework 4.6.NET Framework 4.6, asynchronous operations by default inherit the values of the CurrentCulture and CurrentUICulture properties of the thread from which they are launched. 現在のカルチャまたは現在の UI カルチャはシステム カルチャによって異なる場合、現在のカルチャはスレッドの境界を越えるし、非同期操作を実行しているスレッド プールのスレッドの現在のカルチャになります。If the current culture or current UI culture differs from the system culture, the current culture crosses thread boundaries and becomes the current culture of the thread pool thread that is executing an asynchronous operation.

簡単な例を次に示します。The following example provides a simple illustration. 使用して、TargetFrameworkAttribute属性ターゲットを.NET Framework 4.6.NET Framework 4.6します。It uses the TargetFrameworkAttribute attribute to target the .NET Framework 4.6.NET Framework 4.6. 例では、定義、Func<TResult>デリゲートformatDelegate通貨値として書式設定された数値を返します。The example defines a Func<TResult> delegate, formatDelegate, that returns some numbers formatted as currency values. 例は、フランス語 (フランス) に、現在のシステム カルチャを変更する場合、フランス語 (フランス) が現在のカルチャでは、英語 (米国) です。The example changes the current system culture to either French (France) or, if French (France) is already the current culture, English (United States). その後:It then:

  • メイン アプリケーション スレッドで同期的に実行されるように、デリゲートを直接呼び出します。Invokes the delegate directly so that it runs synchronously on the main app thread.

  • スレッド プールのスレッドでデリゲートを非同期的に実行するタスクを作成します。Creates a task that executes the delegate asynchronously on a thread pool thread.

  • 呼び出すことによって、メイン アプリケーション スレッドでデリゲートを同期的に実行するタスクを作成、Task.RunSynchronouslyメソッド。Creates a task that executes the delegate synchronously on the main app thread by calling the Task.RunSynchronously method.

例の出力を示しています、現在のカルチャをフランス語 (フランス) に変更されたときの元のタスクは非同期的に呼び出すスレッドの現在のカルチャが非同期操作の現在のカルチャになります。As the output from the example shows, when the current culture is changed to French (France), the current culture of the thread from which tasks are invoked asynchronously becomes the current culture for that asynchronous operation.

using System;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

[assembly:TargetFramework(".NETFramework,Version=v4.6")]

public class Example
{
   
   public static void Main()
   {
       decimal[] values = { 163025412.32m, 18905365.59m };
       string formatString = "C2";
       Func<String> formatDelegate = () => { string output = String.Format("Formatting using the {0} culture on thread {1}.\n",
                                                                           CultureInfo.CurrentCulture.Name,
                                                                           Thread.CurrentThread.ManagedThreadId);
                                             foreach (var value in values)
                                                output += String.Format("{0}   ", value.ToString(formatString));
                                                   
                                             output += Environment.NewLine;
                                             return output;
                                           };
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId);
       // Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name);
       if (CultureInfo.CurrentCulture.Name == "fr-FR")
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
       else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");

       Console.WriteLine("Changed the current culture to {0}.\n",
                         CultureInfo.CurrentCulture.Name);
       
       // Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:");
       Console.WriteLine(formatDelegate());
       
       // Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:"); 
       var t1 = Task.Run(formatDelegate);
       Console.WriteLine(t1.Result);
       
       Console.WriteLine("Executing a task synchronously:");
       var t2 = new Task<String>(formatDelegate); 
       t2.RunSynchronously();
       Console.WriteLine(t2.Result);
   }
}
// The example displays the following output:
//         The example is running on thread 1
//         The current culture is en-US
//         Changed the current culture to fr-FR.
//
//         Executing the delegate synchronously:
//         Formatting using the fr-FR culture on thread 1.
//         163 025 412,32 €   18 905 365,59 €
//
//         Executing a task asynchronously:
//         Formatting using the fr-FR culture on thread 3.
//         163 025 412,32 €   18 905 365,59 €
//
//         Executing a task synchronously:
//         Formatting using the fr-FR culture on thread 1.
//         163 025 412,32 €   18 905 365,59 €
Imports System.Globalization
Imports System.Runtime.Versioning
Imports System.Threading
Imports System.Threading.Tasks

<Assembly:TargetFramework(".NETFramework,Version=v4.6")>

Module Example
   Public Sub Main()
       Dim values() As Decimal = { 163025412.32d, 18905365.59d }
       Dim formatString As String = "C2"
       Dim formatDelegate As Func(Of String) = Function()
                                                  Dim output As String = String.Format("Formatting using the {0} culture on thread {1}.",
                                                                                       CultureInfo.CurrentCulture.Name,
                                                                                       Thread.CurrentThread.ManagedThreadId)
                                                  output += Environment.NewLine
                                                  For Each value In values
                                                     output += String.Format("{0}   ", value.ToString(formatString))
                                                  Next 
                                                  output += Environment.NewLine
                                                  Return output
                                               End Function
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId)
       ' Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name)
       If CultureInfo.CurrentCulture.Name = "fr-FR" Then
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US")
       Else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR")
       End If
       Console.WriteLine("Changed the current culture to {0}.",
                         CultureInfo.CurrentCulture.Name)
       Console.WriteLine()                  
       
       ' Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:")
       Console.WriteLine(formatDelegate())
       
       ' Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:") 
       Dim t1 = Task.Run(formatDelegate)
       Console.WriteLine(t1.Result)
       
       Console.WriteLine("Executing a task synchronously:")
       Dim t2 = New Task(Of String)(formatDelegate) 
       t2.RunSynchronously()
       Console.WriteLine(t2.Result)
   End Sub
End Module
' The example displays the following output:
'          The example is running on thread 1
'          The current culture is en-US
'          Changed the current culture to fr-FR.
'
'          Executing the delegate synchronously:
'          Formatting Imports the fr-FR culture on thread 1.
'          163 025 412,32 €   18 905 365,59 €
'
'          Executing a task asynchronously:
'          Formatting Imports the fr-FR culture on thread 3.
'          163 025 412,32 €   18 905 365,59 €
'
'          Executing a task synchronously:
'          Formatting Imports the fr-FR culture on thread 1.
'          163 025 412,32 €   18 905 365,59 €

前のバージョンの .NET Framework のバージョンを対象とするアプリを.NET Framework 4.6.NET Framework 4.6、または特定のバージョンの .NET Framework を対象としないアプリの場合は、呼び出し元のスレッドのカルチャが含まれていない、タスクのコンテキスト。For apps that target versions of the .NET Framework prior to the .NET Framework 4.6.NET Framework 4.6, or for apps that do not target a particular version of the .NET Framework, the culture of the calling thread is not part of a task's context. 代わりに、1 つは明示的に定義されていない場合、既定では新しいスレッドのカルチャは、システム カルチャになります。Instead, unless one is explicitly defined, the culture of new threads by default is the system culture. 次の例がないことを除いて前の例と同じですが、TargetFrameworkAttribute属性、これを示しています。The following example, which is identical to the previous example except that it lacks the TargetFrameworkAttribute attribute, illustrates this. スレッド プールのスレッドで非同期に実行されるタスクのカルチャは EN-US 個ではなく、例を実行するシステムのシステム カルチャが英語 (米国) であるため、します。Because the system culture of the system on which the example executed was English (United States), the culture of the task that executes asynchronously on a thread pool thread is en-US rather than fr-FR.

using System;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
       decimal[] values = { 163025412.32m, 18905365.59m };
       string formatString = "C2";
       Func<String> formatDelegate = () => { string output = String.Format("Formatting using the {0} culture on thread {1}.\n",
                                                                           CultureInfo.CurrentCulture.Name,
                                                                           Thread.CurrentThread.ManagedThreadId);
                                             foreach (var value in values)
                                                output += String.Format("{0}   ", value.ToString(formatString));
                                                   
                                             output += Environment.NewLine;
                                             return output;
                                           };
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId);
       // Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name);
       if (CultureInfo.CurrentCulture.Name == "fr-FR")
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
       else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");

       Console.WriteLine("Changed the current culture to {0}.\n",
                         CultureInfo.CurrentCulture.Name);
       
       // Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:");
       Console.WriteLine(formatDelegate());
       
       // Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:"); 
       var t1 = Task.Run(formatDelegate);
       Console.WriteLine(t1.Result);
       
       Console.WriteLine("Executing a task synchronously:");
       var t2 = new Task<String>(formatDelegate); 
       t2.RunSynchronously();
       Console.WriteLine(t2.Result);
   }
}
// The example displays the following output:
//     The example is running on thread 1
//     The current culture is en-US
//     Changed the current culture to fr-FR.
//     
//     Executing the delegate synchronously:
//     Formatting using the fr-FR culture on thread 1.
//     163 025 412,32 €   18 905 365,59 €
//     
//     Executing a task asynchronously:
//     Formatting using the en-US culture on thread 3.
//     $163,025,412.32   $18,905,365.59
//     
//     Executing a task synchronously:
//     Formatting using the fr-FR culture on thread 1.
//     163 025 412,32 €   18 905 365,59 €
Imports System.Globalization
Imports System.Runtime.Versioning
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
       Dim values() As Decimal = { 163025412.32d, 18905365.59d }
       Dim formatString As String = "C2"
       Dim formatDelegate As Func(Of String) = Function()
                                                  Dim output As String = String.Format("Formatting using the {0} culture on thread {1}.",
                                                                                       CultureInfo.CurrentCulture.Name,
                                                                                       Thread.CurrentThread.ManagedThreadId)
                                                  output += Environment.NewLine
                                                  For Each value In values
                                                     output += String.Format("{0}   ", value.ToString(formatString))
                                                  Next 
                                                  output += Environment.NewLine
                                                  Return output
                                               End Function
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId)
       ' Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name)
       If CultureInfo.CurrentCulture.Name = "fr-FR" Then
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US")
       Else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR")
       End If
       Console.WriteLine("Changed the current culture to {0}.",
                         CultureInfo.CurrentCulture.Name)
       Console.WriteLine()                  
       
       ' Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:")
       Console.WriteLine(formatDelegate())
       
       ' Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:") 
       Dim t1 = Task.Run(formatDelegate)
       Console.WriteLine(t1.Result)
       
       Console.WriteLine("Executing a task synchronously:")
       Dim t2 = New Task(Of String)(formatDelegate) 
       t2.RunSynchronously()
       Console.WriteLine(t2.Result)
   End Sub
End Module
' The example displays the following output:
'     The example is running on thread 1
'     The current culture is en-US
'     Changed the current culture to fr-FR.
'     
'     Executing the delegate synchronously:
'     Formatting using the fr-FR culture on thread 1.
'     163 025 412,32 €   18 905 365,59 €
'     
'     Executing a task asynchronously:
'     Formatting using the en-US culture on thread 3.
'     $163,025,412.32   $18,905,365.59
'     
'     Executing a task synchronously:
'     Formatting using the fr-FR culture on thread 1.
'     163 025 412,32 €   18 905 365,59 €

.NET Framework のバージョンを対象とするアプリを.NET Framework 4.5.NET Framework 4.5より前のバージョンと、後で、 .NET Framework 4.6.NET Framework 4.6、使用することができます、DefaultThreadCurrentCultureDefaultThreadCurrentUICultureタスクを非同期で呼び出し元のスレッドのカルチャが使用されるようにするプロパティスレッド プールのスレッドで実行します。For apps that target versions of the .NET Framework from the .NET Framework 4.5.NET Framework 4.5 and later but prior to the .NET Framework 4.6.NET Framework 4.6, you can use the DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture properties to ensure that the culture of the calling thread is used in asynchronous tasks that execute on thread pool threads. 使用する点を除いて、次の例は、前の例と同じ、DefaultThreadCurrentCultureがある、メイン アプリケーション スレッドと同じカルチャのプロパティをそのスレッド プールのスレッドを確認します。The following example is identical to the previous example, except that it uses the DefaultThreadCurrentCulture property to ensure that thread pool threads have the same culture as the main app thread.

using System;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
       decimal[] values = { 163025412.32m, 18905365.59m };
       string formatString = "C2";
       Func<String> formatDelegate = () => { string output = String.Format("Formatting using the {0} culture on thread {1}.\n",
                                                                           CultureInfo.CurrentCulture.Name,
                                                                           Thread.CurrentThread.ManagedThreadId);
                                             foreach (var value in values)
                                                output += String.Format("{0}   ", value.ToString(formatString));
                                                   
                                             output += Environment.NewLine;
                                             return output;
                                           };
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId);
       // Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name);
       if (CultureInfo.CurrentCulture.Name == "fr-FR")
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
       else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");

       Console.WriteLine("Changed the current culture to {0}.\n",
                         CultureInfo.CurrentCulture.Name);
       CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CurrentCulture;
       
       // Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:");
       Console.WriteLine(formatDelegate());
       
       // Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:"); 
       var t1 = Task.Run(formatDelegate);
       Console.WriteLine(t1.Result);
       
       Console.WriteLine("Executing a task synchronously:");
       var t2 = new Task<String>(formatDelegate); 
       t2.RunSynchronously();
       Console.WriteLine(t2.Result);
   }
}
// The example displays the following output:
//     The example is running on thread 1
//     The current culture is en-US
//     Changed the current culture to fr-FR.
//     
//     Executing the delegate synchronously:
//     Formatting using the fr-FR culture on thread 1.
//     163 025 412,32 €   18 905 365,59 €
//     
//     Executing a task asynchronously:
//     Formatting using the fr-FR culture on thread 3.
//     163 025 412,32 €   18 905 365,59 €
//     
//     Executing a task synchronously:
//     Formatting using the fr-FR culture on thread 1.
//     163 025 412,32 €   18 905 365,59 €
Imports System.Globalization
Imports System.Runtime.Versioning
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
       Dim values() As Decimal = { 163025412.32d, 18905365.59d }
       Dim formatString As String = "C2"
       Dim formatDelegate As Func(Of String) = Function()
                                                  Dim output As String = String.Format("Formatting using the {0} culture on thread {1}.",
                                                                                       CultureInfo.CurrentCulture.Name,
                                                                                       Thread.CurrentThread.ManagedThreadId)
                                                  output += Environment.NewLine
                                                  For Each value In values
                                                     output += String.Format("{0}   ", value.ToString(formatString))
                                                  Next 
                                                  output += Environment.NewLine
                                                  Return output
                                               End Function
       
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId)
       ' Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name)
       If CultureInfo.CurrentCulture.Name = "fr-FR" Then
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US")
       Else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR")
       End If
       Console.WriteLine("Changed the current culture to {0}.",
                         CultureInfo.CurrentCulture.Name)
       CultureInfo.DefaultThreadCurrentCulture = CultureInfo.CurrentCulture
       Console.WriteLine()                  
       
       ' Execute the delegate synchronously.
       Console.WriteLine("Executing the delegate synchronously:")
       Console.WriteLine(formatDelegate())
       
       ' Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously:") 
       Dim t1 = Task.Run(formatDelegate)
       Console.WriteLine(t1.Result)
       
       Console.WriteLine("Executing a task synchronously:")
       Dim t2 = New Task(Of String)(formatDelegate) 
       t2.RunSynchronously()
       Console.WriteLine(t2.Result)
   End Sub
End Module
' The example displays the following output:
'       The example is running on thread 1
'       The current culture is en-US
'       Changed the current culture to fr-FR.
'       
'       Executing the delegate synchronously:
'       Formatting using the fr-FR culture on thread 1.
'       163 025 412,32 €   18 905 365,59 €
'       
'       Executing a task asynchronously:
'       Formatting using the fr-FR culture on thread 3.
'       163 025 412,32 €   18 905 365,59 €
'       
'       Executing a task synchronously:
'       Formatting using the fr-FR culture on thread 1.
'       163 025 412,32 €   18 905 365,59 €

DefaultThreadCurrentCulture DefaultThreadCurrentUICultureアプリごとにドメインのプロパティをすべてのスレッドが特定のアプリケーション ドメイン内のカルチャを明示的に割り当ての既定のカルチャを確立したは、します。DefaultThreadCurrentCulture and DefaultThreadCurrentUICulture are per-app domain properties; that is, they establish a default culture for all threads not explicitly assigned a culture in a specific application domain. ただし、対象とするアプリについて、.NET Framework 4.6.NET Framework 4.6または呼び出し元のスレッドのカルチャが、タスクは、アプリ ドメインの境界を越える場合でも、非同期タスクのコンテキストの一部が後で、します。However, for apps that target the .NET Framework 4.6.NET Framework 4.6 or later, the culture of the calling thread remains part of an asynchronous task's context even if the task crosses app domain boundaries.

タスクを実行しているメソッドは、アプリケーション ドメイン境界を越える場合でも、呼び出し元スレッドのカルチャがタスクベースの非同期操作の現在のカルチャが変更される次の例を示しています。The following example shows that the calling thread's culture remains the current culture of a task-based asynchronous operation even if the method that the task is executing crosses application domain boundaries. クラスを定義DataRetriever、単一のメソッドとGetFormattedNumber1 ~ 1,000 の通貨値として書式設定でランダムな倍精度浮動小数点数を返します。It defines a class, DataRetriever, with a single method, GetFormattedNumber, that returns a random double-precision floating-point number between 1 and 1,000 formatted as a currency value. 最初のタスクが実行されるインスタンスを作成します、DataRetrieverインスタンスと呼び出しのGetFormattedNumberメソッド。A first task is run that simply instantiates a DataRetriever instance and calls its GetFormattedNumber method. 2 番目のタスクその現在のアプリケーション ドメインを報告、新しいアプリケーション ドメインを作成、インスタンス化、DataRetriever新しいアプリケーション ドメインと呼び出しのインスタンス、GetFormattedNumberメソッド。A second task reports its current application domain, creates a new application domain, instantiates a DataRetriever instance in the new application domain, and calls its GetFormattedNumber method. 例の出力が示すように、現在のカルチャが同じまま呼び出し元のスレッド、最初のタスクと 2 番目のタスクでメイン アプリケーションと 2 つ目のアプリケーション ドメインでそれを実行したときにします。As the output from the example shows, the current culture has remained the same in the calling thread, the first task, and the second task both when it was executing in the main application domain and the second application domain.

using System;
using System.Globalization;
using System.Runtime.Versioning;
using System.Threading;
using System.Threading.Tasks;

[assembly:TargetFramework(".NETFramework,Version=v4.6")]

public class Example
{
   public static void Main()
   {
       string formatString = "C2";
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId);
       // Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name);
       if (CultureInfo.CurrentCulture.Name == "fr-FR")
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
       else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR");

       Console.WriteLine("Changed the current culture to {0}.\n",
                         CultureInfo.CurrentCulture.Name);
       
       // Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously in the main appdomain:"); 
       var t1 = Task.Run(() => { DataRetriever d = new DataRetriever();
                                 return d.GetFormattedNumber(formatString);
                               });
       Console.WriteLine(t1.Result);
       Console.WriteLine(); 
       
       Console.WriteLine("Executing a task synchronously in two appdomains:");
       var t2 = Task.Run(() => { Console.WriteLine("Thread {0} is running in app domain '{1}'", 
                                                   Thread.CurrentThread.ManagedThreadId, 
                                                   AppDomain.CurrentDomain.FriendlyName);
                                 AppDomain domain = AppDomain.CreateDomain("Domain2");
                                 DataRetriever d = (DataRetriever) domain.CreateInstanceAndUnwrap(typeof(Example).Assembly.FullName,
                                                   "DataRetriever");
                                 return d.GetFormattedNumber(formatString); 
                               }); 
       Console.WriteLine(t2.Result);
   }
}

public class DataRetriever : MarshalByRefObject
{
   public string GetFormattedNumber(String format)
   {
      Thread thread = Thread.CurrentThread;
      Console.WriteLine("Current culture is {0}", thread.CurrentCulture);
      Console.WriteLine("Thread {0} is running in app domain '{1}'", 
                        thread.ManagedThreadId, 
                        AppDomain.CurrentDomain.FriendlyName);
      Random rnd = new Random();
      Double value = rnd.NextDouble() * 1000;
      return value.ToString(format);
   }
}
// The example displays output like the following:
//     The example is running on thread 1
//     The current culture is en-US
//     Changed the current culture to fr-FR.
//     
//     Executing a task asynchronously in a single appdomain:
//     Current culture is fr-FR
//     Thread 3 is running in app domain 'AsyncCulture4.exe'
//     93,48 €
//     
//     Executing a task synchronously in two appdomains:
//     Thread 4 is running in app domain 'AsyncCulture4.exe'
//     Current culture is fr-FR
//     Thread 4 is running in app domain 'Domain2'
//     288,66 €
Imports System.Globalization
Imports System.Runtime.Versioning
Imports System.Threading
Imports System.Threading.Tasks

<Assembly:TargetFramework(".NETFramework,Version=v4.6")>

Module Example
   Public Sub Main()
       Dim formatString As String = "C2"
       Console.WriteLine("The example is running on thread {0}", 
                         Thread.CurrentThread.ManagedThreadId)
       ' Make the current culture different from the system culture.
       Console.WriteLine("The current culture is {0}", 
                         CultureInfo.CurrentCulture.Name)
       If CultureInfo.CurrentCulture.Name = "fr-FR" Then
          Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US")
       Else
          Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-FR")
       End If

       Console.WriteLine("Changed the current culture to {0}.",
                         CultureInfo.CurrentCulture.Name)
       Console.WriteLine()
       
       ' Call an async delegate to format the values using one format string.
       Console.WriteLine("Executing a task asynchronously in the main appdomain:") 
       Dim t1 = Task.Run(Function()
                            Dim d As New DataRetriever()
                            Return d.GetFormattedNumber(formatString)
                         End Function)
       Console.WriteLine(t1.Result)
       Console.WriteLine() 
       
       Console.WriteLine("Executing a task synchronously in two appdomains:")
       Dim t2 = Task.Run(Function()
                            Console.WriteLine("Thread {0} is running in app domain '{1}'", 
                                              Thread.CurrentThread.ManagedThreadId, 
                                              AppDomain.CurrentDomain.FriendlyName)
                            Dim domain As AppDomain = AppDomain.CreateDomain("Domain2")
                            Dim d As DataRetriever = CType(domain.CreateInstanceAndUnwrap(GetType(Example).Assembly.FullName,
                                                                                          "DataRetriever"), DataRetriever)
                            Return d.GetFormattedNumber(formatString) 
                         End Function) 
       Console.WriteLine(t2.Result)
   End Sub
End Module

Public Class DataRetriever : Inherits MarshalByRefObject
   Public Function GetFormattedNumber(format As String) As String
      Dim thread As Thread = Thread.CurrentThread
      Console.WriteLine("Current culture is {0}", thread.CurrentCulture)
      Console.WriteLine("Thread {0} is running in app domain '{1}'", 
                        thread.ManagedThreadId, 
                        AppDomain.CurrentDomain.FriendlyName)
      Dim rnd As New Random()
      Dim value As Double = rnd.NextDouble() * 1000
      Return value.ToString(format)
   End Function
End Class
' The example displays output like the following:
'     The example is running on thread 1
'     The current culture is en-US
'     Changed the current culture to fr-FR.
'     
'     Executing a task asynchronously in a single appdomain:
'     Current culture is fr-FR
'     Thread 3 is running in app domain 'AsyncCulture4.exe'
'     93,48 €
'     
'     Executing a task synchronously in two appdomains:
'     Thread 4 is running in app domain 'AsyncCulture4.exe'
'     Current culture is fr-FR
'     Thread 4 is running in app domain 'Domain2'
'     288,66 €

CultureInfo オブジェクトのシリアル化CultureInfo object serialization

ときに、CultureInfoオブジェクトがシリアル化、実際に格納されているはNameUseUserOverrideします。When a CultureInfo object is serialized, all that is actually stored is Name and UseUserOverride. 環境でのみ正常に逆シリアル化は場所をName同じ意味を持ちます。It is successfully de-serialized only in an environment where that Name has the same meaning. これが理由は次の 3 つの例を表示する場合。The following three examples show why this is not always the case:

  • 場合、CultureTypesプロパティの値がSystem.Globalization.CultureTypes、し、そのカルチャは、Windows Vista または Windows オペレーティング システムの以降のバージョンで初めて導入されたの場合は、Windows XP で逆シリアル化することはできません。If the CultureTypes property value is System.Globalization.CultureTypes, and if that culture was first introduced in Windows Vista or a later version of the Windows operating system, it is not possible to de-serialize it on Windows XP. 同様に、カルチャは、Windows XP Service Pack 2 で初めて導入されたの場合は、カルチャがインストールされていない Windows XP システムをシリアル化を解除することはできません。Similarly, if the culture was first introduced in Windows XP Service Pack 2, it is not possible to de-serialize it for a Windows XP system on which the culture has not been installed.

  • 場合、CultureTypes値はSystem.Globalization.CultureTypesがシリアル化解除されたコンピューターにインストールされているこのユーザーのカスタム カルチャがないとは、逆シリアル化することはできません。If the CultureTypes value is System.Globalization.CultureTypes, and the computer on which it is de-serialized does not have this user custom culture installed, it is not possible to de-serialize it.

  • 場合、CultureTypes値はSystem.Globalization.CultureTypesがシリアル化解除されたコンピューターには、この置換カルチャはありません。 とは、同じ特性をすべてではなく、同じ名前を逆シリアル化します。If the CultureTypes value is System.Globalization.CultureTypes, and the computer on which it is de-serialized does not have this replacement culture, it de-serializes to the same name, but not all of the same characteristics. たとえば、EN-US がコンピューター B ではなくが、コンピューター A では、置換カルチャをCultureInfoオブジェクトを参照するこのカルチャはコンピューター A でシリアル化され、コンピューター B でシリアル化解除は、カルチャのカスタムの特性を none転送されます。For example, if en-US is a replacement culture on computer A, but not on computer B, and if a CultureInfo object referring to this culture is serialized on computer A and de-serialized on computer B, then none of the custom characteristics of the culture are transmitted. カルチャには、異なる意味を持つが、正常に逆シリアル化します。The culture de-serializes successfully, but with a different meaning.

コントロール パネルのオーバーライドControl Panel overrides

ユーザーは、コントロール パネルの地域と言語に関するオプションを使用して Windows の現在のカルチャに関連付けられている値の一部をオーバーライドすることもできます。The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. など、ユーザーでは、カルチャの既定以外の通貨を使用するか別の形式で日付を表示することもできます。For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. 一般に、アプリケーションでは、これらのユーザー オーバーライドを受け入れる必要があります。In general, your applications should honor these user overrides.

場合UseUserOverridetrueと指定したカルチャには、Windows の現在のカルチャが一致する、CultureInfoユーザーのプロパティの設定など、これらの上書きを使用して、DateTimeFormatInfoによって返されるインスタンス、DateTimeFormatプロパティプロパティと、NumberFormatInfoによって返されるインスタンス、NumberFormatプロパティ。If UseUserOverride is true and the specified culture matches the current culture of Windows, the CultureInfo uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. ユーザー設定が関連付けられているカルチャと互換性がないかどうか、 CultureInfo、たとえば、選択したカレンダーは、のいずれかでがない場合、OptionalCalendarsメソッドの結果と、プロパティの値が定義されていません。If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

代替の並べ替え順序Alternate sort orders

一部のカルチャでは、複数の並べ替え順序がサポートされています。Some cultures support more than one sort order. 例:For example:

  • スペイン語 (スペイン) カルチャが 2 つの並べ替え順序: 既定のインターナショナル ソート順序と従来の並べ替え順序。The Spanish (Spain) culture has two sort orders: the default international sort order, and the traditional sort order. インスタンス化すると、 CultureInfo ES-ES カルチャの名前を持つオブジェクトのインターナショナル ソート順序が使用されます。When you instantiate a CultureInfo object with the es-ES culture name, the international sort order is used. インスタンス化すると、 CultureInfo es-ES-tradnl カルチャの名前を持つオブジェクトの従来の並べ替え順序を使用します。When you instantiate a CultureInfo object with the es-ES-tradnl culture name, the traditional sort order is used.

  • ZH-CN (中国語 (簡体字、中国)) のカルチャには、2 つの並べ替え順序がサポートされています: と画数によって発音 (既定)。The zh-CN (Chinese (Simplified, PRC)) culture supports two sort orders: by pronunciation (the default) and by stroke count. インスタンス化すると、 CultureInfo ZH-CN カルチャの名前を持つオブジェクトの既定の並べ替え順序を使用します。When you instantiate a CultureInfo object with the zh-CN culture name, the default sort order is used. インスタンス化すると、 CultureInfo 0x00020804 のローカル識別子を持つオブジェクトの文字列は画数によって並べ替えられます。When you instantiate a CultureInfo object with a local identifier of 0x00020804, strings are sorted by stroke count.

代替の並べ替え順序をサポートするカルチャと、各カルチャの既定の並べ替え順序および代替の並べ替え順序の識別子を次の表に示します。The following table lists the cultures that support alternate sort orders and the identifiers for the default and alternate sort orders.

カルチャ名Culture name cultureCulture 既定の並べ替え名と識別子Default sort name and identifier 代替の並べ替え名と識別子Alternate sort name and identifier
es-ESes-ES スペイン語 (スペイン)Spanish (Spain) International: 0x00000C0AInternational: 0x00000C0A Traditional: 0x0000040ATraditional: 0x0000040A
zh-TWzh-TW 中国語 (台湾)Chinese (Taiwan) Stroke Count: 0x00000404Stroke Count: 0x00000404 Bopomofo: 0x00030404Bopomofo: 0x00030404
zh-CNzh-CN 中国語 (中国)Chinese (PRC) Pronunciation: 0x00000804Pronunciation: 0x00000804 Stroke Count: 0x00020804Stroke Count: 0x00020804
zh-HKzh-HK 中国語 (香港特別行政区)Chinese (Hong Kong SAR) Stroke Count: 0x00000c04Stroke Count: 0x00000c04 Stroke Count: 0x00020c04Stroke Count: 0x00020c04
zh-SGzh-SG 中国語 (シンガポール)Chinese (Singapore) Pronunciation: 0x00001004Pronunciation: 0x00001004 Stroke Count: 0x00021004Stroke Count: 0x00021004
zh-MOzh-MO 中国語 (マカオ)Chinese (Macao SAR) Pronunciation: 0x00001404Pronunciation: 0x00001404 Stroke Count: 0x00021404Stroke Count: 0x00021404
ja-JPja-JP 日本語 (日本)Japanese (Japan) Default: 0x00000411Default: 0x00000411 Unicode: 0x00010411Unicode: 0x00010411
ko-KRko-KR 韓国語 (韓国)Korean (Korea) Default: 0x00000412Default: 0x00000412 Korean Xwansung - Unicode: 0x00010412Korean Xwansung - Unicode: 0x00010412
de-DEde-DE ドイツ語 (ドイツ)German (Germany) Dictionary: 0x00000407Dictionary: 0x00000407 Phone Book Sort DIN: 0x00010407Phone Book Sort DIN: 0x00010407
hu-HUhu-HU ハンガリー語 (ハンガリー)Hungarian (Hungary) Default: 0x0000040eDefault: 0x0000040e Technical Sort: 0x0001040eTechnical Sort: 0x0001040e
ka-GEka-GE グルジア語 (グルジア共和国)Georgian (Georgia) Traditional: 0x00000437Traditional: 0x00000437 Modern Sort: 0x00010437Modern Sort: 0x00010437

現在のカルチャと UWP アプリThe current culture and UWP apps

ユニバーサル Windows プラットフォーム (UWP) アプリで、CurrentCultureCurrentUICultureで .NET Framework と .NET Core アプリと同様、プロパティは読み取り/書き込みです。In Universal Windows Platform (UWP) apps, the CurrentCulture and CurrentUICulture properties are read-write, just as they are in .NET Framework and .NET Core apps. ただし、UWP アプリは、1 つのカルチャを認識します。However, UWP apps recognize a single culture. CurrentCultureCurrentUICultureプロパティ マップの最初の値をWindows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languagesコレクション。The CurrentCulture and CurrentUICulture properties map to the first value in the Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages collection.

.NET Framework と .NET Core アプリでは、現在のカルチャはスレッドごとの設定では、およびCurrentCultureCurrentUICultureカルチャおよび UI カルチャの現在のスレッドのみのプロパティに反映されます。In .NET Framework and .NET Core apps, the current culture is a per-thread setting, and the CurrentCulture and CurrentUICulture properties reflect the culture and UI culture of the current thread only. UWP アプリでは、現在のカルチャをマップ、 Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languagesコレクションは、これはグローバル設定です。In UWP apps, the current culture maps to the Windows.ApplicationModel.Resources.Core.ResourceManager.DefaultContext.Languages collection, which is a global setting. 設定、CurrentCultureまたはCurrentUICultureプロパティは、アプリ全体のカルチャを変更; カルチャはスレッドごとに設定できません。Setting the CurrentCulture or CurrentUICulture property changes the culture of the entire app; culture cannot be set on a per-thread basis.

コンストラクター

CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32)

カルチャ識別子によって指定するカルチャに基づいて、CultureInfo クラスの新しいインスタンスを初期化します。Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean)

カルチャ識別子で指定したカルチャと、システムからユーザーが選択したカルチャを使用するかどうかを指定するブール値に基づいて、CultureInfo クラスの新しいインスタンスを初期化します。Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(String) CultureInfo(String) CultureInfo(String) CultureInfo(String)

名前で指定するカルチャに基づいて、CultureInfo クラスの新しいインスタンスを初期化します。Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean)

名前で指定したカルチャと、システムからユーザーが選択したカルチャ設定を使用するかどうかを指定するブール値に基づいて、CultureInfo クラスの新しいインスタンスを初期化します。Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

プロパティ

Calendar Calendar Calendar Calendar

カルチャで使用する既定の暦を取得します。Gets the default calendar used by the culture.

CompareInfo CompareInfo CompareInfo CompareInfo

カルチャの文字列を比較する方法を定義する CompareInfo を取得します。Gets the CompareInfo that defines how to compare strings for the culture.

CultureTypes CultureTypes CultureTypes CultureTypes

現在の CultureInfo オブジェクトに関するカルチャ タイプを取得します。Gets the culture types that pertain to the current CultureInfo object.

CurrentCulture CurrentCulture CurrentCulture CurrentCulture

現在のスレッドで使用するカルチャを表す CultureInfo オブジェクトを取得または設定します。Gets or sets the CultureInfo object that represents the culture used by the current thread.

CurrentUICulture CurrentUICulture CurrentUICulture CurrentUICulture

実行時にカルチャ固有のリソースを参照するためにリソース マネージャーによって使用される現在のユーザー インターフェイスのカルチャを表す CultureInfo オブジェクトを取得または設定します。Gets or sets the CultureInfo object that represents the current user interface culture used by the Resource Manager to look up culture-specific resources at run time.

DateTimeFormat DateTimeFormat DateTimeFormat DateTimeFormat

カルチャに対応する、日時の表示形式を定義する DateTimeFormatInfo を取得または設定します。Gets or sets a DateTimeFormatInfo that defines the culturally appropriate format of displaying dates and times.

DefaultThreadCurrentCulture DefaultThreadCurrentCulture DefaultThreadCurrentCulture DefaultThreadCurrentCulture

現在のアプリケーション ドメインのスレッドの既定のカルチャを取得または設定します。Gets or sets the default culture for threads in the current application domain.

DefaultThreadCurrentUICulture DefaultThreadCurrentUICulture DefaultThreadCurrentUICulture DefaultThreadCurrentUICulture

現在のアプリケーション ドメイン内のスレッドの既定 UI カルチャを取得または設定します。Gets or sets the default UI culture for threads in the current application domain.

DisplayName DisplayName DisplayName DisplayName

完全にローカライズされたカルチャ名を取得します。Gets the full localized culture name.

EnglishName EnglishName EnglishName EnglishName

英語で表した "languagefull [country/regionfull]" という形式のカルチャ名を取得します。Gets the culture name in the format languagefull [country/regionfull] in English.

IetfLanguageTag IetfLanguageTag IetfLanguageTag IetfLanguageTag

非推奨。Deprecated. 言語の RFC 4646 標準 ID を取得します。Gets the RFC 4646 standard identification for a language.

InstalledUICulture InstalledUICulture InstalledUICulture InstalledUICulture

オペレーティング システムと共にインストールされたカルチャを表す CultureInfo を取得します。Gets the CultureInfo that represents the culture installed with the operating system.

InvariantCulture InvariantCulture InvariantCulture InvariantCulture

カルチャに依存しない (インバリアントな) CultureInfo オブジェクトを取得します。Gets the CultureInfo object that is culture-independent (invariant).

IsNeutralCulture IsNeutralCulture IsNeutralCulture IsNeutralCulture

現在の CultureInfo がニュートラル カルチャを表しているかどうかを示す値を取得します。Gets a value indicating whether the current CultureInfo represents a neutral culture.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

現在の CultureInfo が読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the current CultureInfo is read-only.

KeyboardLayoutId KeyboardLayoutId KeyboardLayoutId KeyboardLayoutId

アクティブな入力ロケール識別子を取得します。Gets the active input locale identifier.

LCID LCID LCID LCID

現在の CultureInfo のカルチャ識別子を取得します。Gets the culture identifier for the current CultureInfo.

Name Name Name Name

languagecode2-country/regioncode2 という形式のカルチャ名を取得します。Gets the culture name in the format languagecode2-country/regioncode2.

NativeName NativeName NativeName NativeName

カルチャの表示設定である、言語、国/地域、およびオプションのスクリプトで構成されるカルチャ名を取得します。Gets the culture name, consisting of the language, the country/region, and the optional script, that the culture is set to display.

NumberFormat NumberFormat NumberFormat NumberFormat

数値、通貨、割合を表示する、カルチャに対応する書式を定義する NumberFormatInfo を取得または設定します。Gets or sets a NumberFormatInfo that defines the culturally appropriate format of displaying numbers, currency, and percentage.

OptionalCalendars OptionalCalendars OptionalCalendars OptionalCalendars

カルチャで使用できる暦の一覧を取得します。Gets the list of calendars that can be used by the culture.

Parent Parent Parent Parent

現在の CultureInfo の親カルチャを表す CultureInfo を取得します。Gets the CultureInfo that represents the parent culture of the current CultureInfo.

TextInfo TextInfo TextInfo TextInfo

カルチャに関連付けられている書記体系を定義する TextInfo を取得します。Gets the TextInfo that defines the writing system associated with the culture.

ThreeLetterISOLanguageName ThreeLetterISOLanguageName ThreeLetterISOLanguageName ThreeLetterISOLanguageName

現在の CultureInfo の言語に対する ISO 639-2 の 3 桁の文字コードを取得します。Gets the ISO 639-2 three-letter code for the language of the current CultureInfo.

ThreeLetterWindowsLanguageName ThreeLetterWindowsLanguageName ThreeLetterWindowsLanguageName ThreeLetterWindowsLanguageName

Windows API の定義に従って、言語に対する 3 文字コードを取得します。Gets the three-letter code for the language as defined in the Windows API.

TwoLetterISOLanguageName TwoLetterISOLanguageName TwoLetterISOLanguageName TwoLetterISOLanguageName

現在の CultureInfo の言語に対する ISO 639-1 の 2 桁の文字コードを取得します。Gets the ISO 639-1 two-letter code for the language of the current CultureInfo.

UseUserOverride UseUserOverride UseUserOverride UseUserOverride

現在の CultureInfo オブジェクトでユーザーが選択したカルチャ設定を使用するかどうかを示す値を取得します。Gets a value indicating whether the current CultureInfo object uses the user-selected culture settings.

メソッド

ClearCachedData() ClearCachedData() ClearCachedData() ClearCachedData()

キャッシュされたカルチャ関連情報を更新します。Refreshes cached culture-related information.

Clone() Clone() Clone() Clone()

現在の CultureInfo のコピーを作成します。Creates a copy of the current CultureInfo.

CreateSpecificCulture(String) CreateSpecificCulture(String) CreateSpecificCulture(String) CreateSpecificCulture(String)

指定した名前に関連付けられている特定のカルチャを表す CultureInfo を作成します。Creates a CultureInfo that represents the specific culture that is associated with the specified name.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが現在の CultureInfo と同じカルチャかどうかを判断します。Determines whether the specified object is the same culture as the current CultureInfo.

GetConsoleFallbackUICulture() GetConsoleFallbackUICulture() GetConsoleFallbackUICulture() GetConsoleFallbackUICulture()

グラフィック ユーザー インターフェイスの既定のカルチャが不適切な場合、コンソール アプリケーションに適した代替のユーザー インターフェイス カルチャを取得します。Gets an alternate user interface culture suitable for console applications when the default graphic user interface culture is unsuitable.

GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32) GetCultureInfo(Int32)

指定されたカルチャ識別子を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String) GetCultureInfo(String)

指定されたカルチャ名を使用して、カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String) GetCultureInfo(String, String)

カルチャのキャッシュされた読み取り専用インスタンスを取得します。Retrieves a cached, read-only instance of a culture. パラメーターは、別のカルチャで指定された TextInfo オブジェクトおよび CompareInfo オブジェクトで初期化されたカルチャを指定します。Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfoByIetfLanguageTag(String) GetCultureInfoByIetfLanguageTag(String) GetCultureInfoByIetfLanguageTag(String) GetCultureInfoByIetfLanguageTag(String)

非推奨。Deprecated. 指定された RFC 4646 言語タグで示される言語特性を持つ、読み取り専用 CultureInfo オブジェクトを取得します。Retrieves a read-only CultureInfo object having linguistic characteristics that are identified by the specified RFC 4646 language tag.

GetCultures(CultureTypes) GetCultures(CultureTypes) GetCultures(CultureTypes) GetCultures(CultureTypes)

サポートされているカルチャを、指定した CultureTypes パラメーターでフィルター処理した結果のリストを取得します。Gets the list of supported cultures filtered by the specified CultureTypes parameter.

GetFormat(Type) GetFormat(Type) GetFormat(Type) GetFormat(Type)

指定した型に書式指定する方法を定義するオブジェクトを取得します。Gets an object that defines how to format the specified type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

現在の CultureInfo のハッシュ関数として機能します。ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。Serves as a hash function for the current CultureInfo, suitable for hashing algorithms and data structures, such as a hash table.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ReadOnly(CultureInfo) ReadOnly(CultureInfo) ReadOnly(CultureInfo) ReadOnly(CultureInfo)

指定した CultureInfo オブジェクトをラップする読み取り専用のラッパーを返します。Returns a read-only wrapper around the specified CultureInfo object.

ToString() ToString() ToString() ToString()

languagecode2-country/regioncode2 という形式で、現在の CultureInfo の名前を格納している文字列を返します。Returns a string containing the name of the current CultureInfo in the format languagecode2-country/regioncode2.

適用対象

こちらもご覧ください