String.ToUpperInvariant Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

String.Manipulation.cs

Mengembalikan salinan objek ini String yang dikonversi ke huruf besar menggunakan aturan casing dari budaya invarian.

public:
 System::String ^ ToUpperInvariant();

public string ToUpperInvariant ();

member this.ToUpperInvariant : unit -> string

Public Function ToUpperInvariant () As String

Mengembalikan

String

Huruf besar yang setara dengan string saat ini.

Contoh

Contoh berikut menentukan array string yang berisi satu kata dalam sejumlah bahasa. Metode ToUpperInvariant ini digunakan untuk mengisi elemen array paralel dengan versi tidak peka huruf besar/kecil dari setiap kata. Metode Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) ini digunakan untuk mengurutkan array peka huruf besar/kecil berdasarkan urutan elemen dalam array huruf besar untuk memastikan bahwa elemen muncul dalam urutan yang sama terlepas dari bahasa.

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
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

open System
open System.IO

do
    let words = 
        [| "Tuesday"; "Salı"; "Вторник"; "Mardi" 
           "Τρίτη"; "Martes"; "יום שלישי" 
           "الثلاثاء"; "วันอังคาร" |]
    use sw = new StreamWriter(@".\output.txt")
        
    // Display array in unsorted order.
    for word in words do
        sw.WriteLine word

    sw.WriteLine()

    // Create parallel array of words by calling ToUpperInvariant.
    let upperWords = words |> Array.map (fun x -> x.ToUpperInvariant())
    
    // Sort the words array based on the order of upperWords.
    Array.Sort(upperWords, words, StringComparer.InvariantCulture)
    
    // Display the sorted array.
    for word in words do
        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
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

Keterangan

Budaya invarian mewakili budaya yang tidak peka budaya. Ini dikaitkan dengan bahasa Inggris tetapi tidak dengan negara atau wilayah tertentu. Untuk informasi selengkapnya, lihat CultureInfo.InvariantCulture properti.

Jika aplikasi Anda bergantung pada kasus string yang berubah dengan cara yang dapat diprediksi yang tidak terpengaruh oleh budaya saat ini, gunakan metode .ToUpperInvariant Metode ToUpperInvariant ini setara dengan ToUpper(CultureInfo.InvariantCulture). Metode ini direkomendasikan ketika kumpulan string harus muncul dalam urutan yang dapat diprediksi dalam kontrol antarmuka pengguna.

Catatan

Metode ini tidak mengubah nilai instans saat ini. Sebaliknya, ia mengembalikan string baru di mana semua karakter dalam instans saat ini dikonversi menjadi huruf besar.

Jika Anda memerlukan versi huruf kecil atau huruf besar dari pengidentifikasi sistem operasi, seperti nama file, pipa bernama, atau kunci registri, gunakan ToLowerInvariant metode atau ToUpperInvariant .

Lihat juga

• ToLowerInvariant()
• ToUpper()
• InvariantCulture