String.ToLowerInvariant String.ToLowerInvariant String.ToLowerInvariant String.ToLowerInvariant Method

定義

インバリアント カルチャの大文字と小文字の規則を使用して、この String オブジェクトのコピーを小文字に変換して返します。Returns a copy of this String object converted to lowercase using the casing rules of the invariant culture.

public:
 System::String ^ ToLowerInvariant();
public string ToLowerInvariant ();
member this.ToLowerInvariant : unit -> string
Public Function ToLowerInvariant () As String

戻り値

現在の文字列を小文字にしたもの。The lowercase equivalent of the current string.

次の例では、さまざまな言語で 1 つの単語を含む文字列配列を定義します。The following example defines a string array that contains a single word in a number of languages. ToLowerInvariantメソッドは、各単語の大文字バージョンと並列配列の要素の設定に使用されます。The ToLowerInvariant method is used to populate the elements of a parallel array with the case-insensitive version of each word. Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>)メソッドは言語に関係なく同じ順序で要素が表示されるように小文字の配列内の要素の順序に基づいて区別配列の並べ替えに使用します。The Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) method is used to sort the case-sensitive array based on the order of elements in the lowercase array to ensure that elements appear in the same order regardless of language.

using System;

public class Example
{
   public static void Main()
   {
      string[] words = { "Tuesday", "Salı", "Вторник", "Mardi", 
                         "Τρίτη", "Martes", "יום שלישי", 
                         "الثلاثاء", "วันอังคาร" };
      // Display array in unsorted order.
      foreach (string word in words)
         Console.WriteLine(word);
      Console.WriteLine();

      // Create parallel array of words by calling ToLowerInvariant.
      string[] lowerWords = new string[words.Length];
      for (int ctr = words.GetLowerBound(0); ctr <= words.GetUpperBound(0); ctr++)
         lowerWords[ctr] = words[ctr].ToLowerInvariant();
      
      // Sort the words array based on the order of lowerWords.
      Array.Sort(lowerWords, words, StringComparer.InvariantCulture);
      
      // Display the sorted array.
      foreach (string word in words)
         Console.WriteLine(word);
   }
}
// The example displays the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
Module Example
   Public Sub Main()
      Dim words() As String = { "Tuesday", "Salı", "Вторник", "Mardi", _
                                "Τρίτη", "Martes", "יום שלישי", _
                                "الثلاثاء", "วันอังคาร" }
      ' Display array in unsorted order.
      For Each word As String In words
         Console.WriteLine(word)
      Next
      Console.WriteLine()

      ' Create parallel array of words by calling ToLowerInvariant.
      Dim lowerWords(words.Length - 1) As String
      For ctr As Integer = words.GetLowerBound(0) To words.GetUpperBound(0)
         lowerWords(ctr) = words(ctr).ToLowerInvariant()
      Next
      
      ' Sort the words array based on the order of lowerWords.
      Array.Sort(lowerWords, words, StringComparer.InvariantCulture)
      
      ' Display the sorted array.
      For Each word As String In words
         Console.WriteLine(word)
      Next
   End Sub
End Module
' The example displays the following output:
'       Tuesday
'       Salı
'       Вторник
'       Mardi
'       Τρίτη
'       Martes
'       יום שלישי
'       الثلاثاء
'       วันอังคาร
'       
'       Mardi
'       Martes
'       Salı
'       Tuesday
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

注釈

インバリアント カルチャでは、カルチャに依存しないられるカルチャを表します。The invariant culture represents a culture that is culture-insensitive. 関連付けられている英語の言語が特定の国または地域を使用できません。It is associated with the English language but not with a specific country or region. 詳細については、CultureInfo.InvariantCulture プロパティを参照してください。For more information, see the CultureInfo.InvariantCulture property.

使用して、現在のカルチャによって影響を受けるある予測可能な方法で変更する文字列の場合に、アプリケーションが依存する場合、ToLowerInvariantメソッド。If your application depends on the case of a string changing in a predictable way that is unaffected by the current culture, use the ToLowerInvariant method. ToLowerInvariantメソッドはToLower(CultureInfo.InvariantCulture)します。The ToLowerInvariant method is equivalent to ToLower(CultureInfo.InvariantCulture). 文字列のコレクションは、ユーザー インターフェイス コントロールでの予測可能な順序で表示する必要があるときに、メソッドの使用をお勧めします。The method is recommended when a collection of strings must appear in a predictable order in a user interface control.

注意

このメソッドは、現在のインスタンスの値を変更できません。This method does not modify the value of the current instance. 代わりに、現在のインスタンス内のすべての文字が小文字に変換する新しい文字列を返します。Instead, it returns a new string in which all characters in the current instance are converted to lowercase.

セキュリティの考慮事項Security Considerations

名前付きパイプ、またはレジストリ キーの使用をファイル名など、オペレーティング システムの識別子の大文字か小文字のバージョンが必要な場合、ToLowerInvariantまたはToUpperInvariantメソッド。If you need the lowercase or uppercase version of an operating system identifier, such as a file name, named pipe, or registry key, use the ToLowerInvariant or ToUpperInvariant methods.

適用対象

こちらもご覧ください