String.ToUpperInvariant メソッド

定義

インバリアント カルチャの大文字と小文字の規則を使用して、この String オブジェクトのコピーを大文字に変換して返します。

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

戻り値

String

現在の文字列を大文字にしたもの。

次の例では、複数の言語で 1 つの単語を含む文字列配列を定義します。 メソッドは、各単語の大文字と小文字を区別しないバージョンを並列配列の要素 ToUpperInvariant に設定するために使用されます。 メソッドを使用して、大文字の配列内の要素の順序に基づいて大文字と小文字を区別する配列を並べ替え、言語に関係なく要素が同じ順序で表示されます Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>)

using System;
using System.IO;

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

      sw.WriteLine();

      // Create parallel array of words by calling ToUpperInvariant.
      string[] upperWords = new string[words.Length];
      for (int ctr = words.GetLowerBound(0); ctr <= words.GetUpperBound(0); ctr++)
         upperWords[ctr] = words[ctr].ToUpperInvariant();
      
      // Sort the words array based on the order of upperWords.
      Array.Sort(upperWords, words, StringComparer.InvariantCulture);
      
      // Display the sorted array.
      foreach (string word in words)
         sw.WriteLine(word);

      sw.Close();      
   }
}
// The example produces the following output:
//       Tuesday
//       Salı
//       Вторник
//       Mardi
//       Τρίτη
//       Martes
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
//       
//       Mardi
//       Martes
//       Salı
//       Tuesday
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
Imports System.IO

Module Example
   Public Sub Main()
      Dim words() As String = { "Tuesday", "Salı", "Вторник", "Mardi", _
                                "Τρίτη", "Martes", "יום שלישי", _
                                "الثلاثاء", "วันอังคาร" }
      Dim sw As New StreamWriter(".\output.txt")
      
      ' Display array in unsorted order.
      For Each word As String In words
         sw.WriteLine(word)
      Next
      sw.WriteLine()

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

注釈

インバリアント カルチャは、カルチャを区別しないカルチャを表します。 英語に関連付けられているが、特定の国や地域には関連付けされていない。 詳細については、CultureInfo.InvariantCulture プロパティを参照してください。

現在のカルチャの影響を受けない予測可能な方法で変化する文字列のケースにアプリケーションが依存している場合は、 メソッドを使用 ToUpperInvariant します。 メソッド ToUpperInvariant は と同じです ToUpper(CultureInfo.InvariantCulture) 。 メソッドは、文字列のコレクションがユーザー インターフェイス コントロールで予測可能な順序で表示される必要がある場合に推奨されます。

注意

このメソッドは、現在のインスタンスの値を変更しない。 代わりに、現在のインスタンス内のすべての文字が大文字に変換される新しい文字列が返されます。

セキュリティに関する考慮事項

ファイル名、名前付きパイプ、レジストリ キーなど、オペレーティング システム識別子の小文字または大文字のバージョンが必要な場合は、 メソッドまたは メソッド ToLowerInvariantToUpperInvariant 使用します。

適用対象

こちらもご覧ください