CultureInfo.InvariantCulture プロパティ

リファレンス

定義

名前空間:: System.Globalization

アセンブリ:: System.Globalization.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

カルチャに依存しない (インバリアントな) CultureInfo オブジェクトを取得します。

public:
 static property System::Globalization::CultureInfo ^ InvariantCulture { System::Globalization::CultureInfo ^ get(); };

public static System.Globalization.CultureInfo InvariantCulture { get; }

static member InvariantCulture : System.Globalization.CultureInfo

Public Shared ReadOnly Property InvariantCulture As CultureInfo

プロパティ値

CultureInfo

カルチャに依存しない (インバリアントな) オブジェクト。

注釈

インバリアントカルチャはカルチャに依存しません。これは英語に関連付けられていますが、国/地域には関連付けされません。インバリアントカルチャを名前で指定するには、インスタンス化メソッドの呼び出しで空の文字列 ("") を CultureInfo 使用します。 CultureInfo.InvariantCulture また、インバリアントカルチャのインスタンスも取得します。カルチャを必要とする名前空間のほぼすべてのメソッドで System.Globalization 使用できます。、などのCompareInfo DateTimeFormatプロパティによって返されるオブジェクトには、NumberFormat不変カルチャの文字列比較と書式設定規則も反映されます。

ユーザーのカスタマイズや、.NET Frameworkやオペレーティングシステムの更新によって変更されるカルチャに依存するデータとは異なり、インバリアントカルチャデータは時間の経過と共に、インストールされているカルチャ間で安定しており、ユーザーがカスタマイズすることはできません。これにより、インバリアントカルチャは、書式設定されたデータを保持する書式設定および解析操作や、カルチャに関係なく固定された順序でデータを表示する必要がある並べ替えと順序付け操作など、カルチャに依存しない結果を必要とする操作に特に役立ちます。

文字列操作

インバリアントカルチャは、現在のカルチャの規則の影響を受けず、カルチャ間で一貫性のあるカルチャに依存する文字列操作に使用できます。たとえば、並べ替えられたデータを固定の順序で表示したり、現在のカルチャに関係なく文字列に標準の大文字と小文字の規則のセットを適用したりできます。これを行うには、や ToUpper(CultureInfo)などのCompare(String, String, Boolean, CultureInfo)パラメーターを持つメソッドにオブジェクトをCultureInfo渡InvariantCultureします。

データの保持

プロパティは InvariantCulture 、カルチャに依存しない形式でデータを保持するために使用できます。これにより、変更されず、カルチャ間でデータをシリアル化および逆シリアル化するために使用できる既知の形式が提供されます。データを逆シリアル化した後は、現在のユーザーのカルチャ規則に基づいて適切に書式設定できます。

たとえば、日付と時刻のデータを文字列形式で保持する場合は、オブジェクトをまたは DateTimeOffset.ToString(IFormatProvider) メソッドに渡InvariantCultureしてDateTime.ToString(String, IFormatProvider)文字列を作成し、オブジェクトをまたは DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) メソッドにDateTime.Parse(String, IFormatProvider)渡InvariantCultureして、文字列を日付と時刻の値に戻すことができます。この手法により、異なるカルチャのユーザーがデータを読み取ったり書き込んだりするときに、基になる日付と時刻の値が変更されないようにします。

次の例では、インバリアントカルチャを使用して、値を DateTime 文字列として保持します。次に、文字列を解析し、フランス語 (フランス) カルチャとドイツ語 (ドイツ) カルチャの書式設定規則を使用してその値を表示します。

using System;
using System.IO;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Persist the date and time data.
      StreamWriter sw = new StreamWriter(@".\DateData.dat");

      // Create a DateTime value.
      DateTime dtIn = DateTime.Now;
      // Retrieve a CultureInfo object.
      CultureInfo invC = CultureInfo.InvariantCulture;

      // Convert the date to a string and write it to a file.
      sw.WriteLine(dtIn.ToString("r", invC));
      sw.Close();

      // Restore the date and time data.
      StreamReader sr = new StreamReader(@".\DateData.dat");
      String input;
      while ((input = sr.ReadLine()) != null)
      {
         Console.WriteLine("Stored data: {0}\n" , input);

         // Parse the stored string.
         DateTime dtOut = DateTime.Parse(input, invC, DateTimeStyles.RoundtripKind);

         // Create a French (France) CultureInfo object.
         CultureInfo frFr = new CultureInfo("fr-FR");
         // Displays the date formatted for the "fr-FR" culture.
         Console.WriteLine("Date formatted for the {0} culture: {1}" ,
                           frFr.Name, dtOut.ToString("f", frFr));

         // Creates a German (Germany) CultureInfo object.
         CultureInfo deDe= new CultureInfo("de-De");
         // Displays the date formatted for the "de-DE" culture.
         Console.WriteLine("Date formatted for {0} culture: {1}" ,
                           deDe.Name, dtOut.ToString("f", deDe));
      }
      sr.Close();
   }
}
// The example displays the following output:
//    Stored data: Tue, 15 May 2012 16:34:16 GMT
//
//    Date formatted for the fr-FR culture: mardi 15 mai 2012 16:34
//    Date formatted for de-DE culture: Dienstag, 15. Mai 2012 16:34

Imports System.Globalization
Imports System.IO

Module Example
   Public Sub Main()
      ' Persist the date and time data.
      Dim sw As New StreamWriter(".\DateData.dat")
      
      ' Create a DateTime value.      
      Dim dtIn As DateTime = DateTime.Now
      ' Retrieve a CultureInfo object.
      Dim invC As CultureInfo = CultureInfo.InvariantCulture
      
      ' Convert the date to a string and write it to a file.
      sw.WriteLine(dtIn.ToString("r", invC))
      sw.Close()

      ' Restore the date and time data.
      Dim sr As New StreamReader(".\DateData.dat")
      Dim input As String = String.Empty
      Do While sr.Peek() >= 0 
         input = sr.ReadLine()
         Console.WriteLine("Stored data: {0}" , input)    
         Console.WriteLine()
         
         ' Parse the stored string.
         Dim dtOut As DateTime = DateTime.Parse(input, invC, DateTimeStyles.RoundtripKind)

         ' Create a French (France) CultureInfo object.
         Dim frFr As New CultureInfo("fr-FR")
         ' Displays the date formatted for the "fr-FR" culture.
         Console.WriteLine("Date formatted for the {0} culture: {1}" , 
                           frFr.Name, dtOut.ToString("f", frFr))

         ' Creates a German (Germany) CultureInfo object.
         Dim deDe As New CultureInfo("de-De")
         ' Displays the date formatted for the "de-DE" culture.
         Console.WriteLine("Date formatted for {0} culture: {1}" , 
                           deDe.Name, dtOut.ToString("f", deDe))
      Loop
      sr.Close()
   End Sub
End Module
' The example displays the following output:
'    Stored data: Tue, 15 May 2012 16:34:16 GMT
'    
'    Date formatted for the fr-FR culture: mardi 15 mai 2012 16:34
'    Date formatted for de-DE culture: Dienstag, 15. Mai 2012 16:34

セキュリティに関する決定事項

文字列比較やケース変更の結果に基づいてセキュリティ上の決定 (システムリソースへのアクセスを許可するかどうかなど) を行う場合は、インバリアントカルチャを使用しないでください。代わりに、パラメーターを含むStringComparisonメソッドを呼び出し、またはを引数として指定することで、大文字と小文字を区別するか、大文字と小文字を区別しない序数比較をStringComparison.Ordinal StringComparison.OrdinalIgnoreCase実行する必要があります。カルチャに依存する文字列操作を実行するコードは、現在のカルチャが変更された場合、またはコードを実行しているコンピューター上のカルチャがコードのテストに使用されるカルチャと異なる場合に、セキュリティの脆弱性を引き起こす可能性があります。これに対し、序数比較は、比較される文字のバイナリ値のみに依存します。

適用対象