String.ToLowerInvariant Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

String.Manipulation.cs

Mengembalikan salinan objek ini String yang dikonversi menjadi huruf kecil menggunakan aturan casing dari kultur invarian.

public:
 System::String ^ ToLowerInvariant();

public string ToLowerInvariant ();

member this.ToLowerInvariant : unit -> string

Public Function ToLowerInvariant () As String

Mengembalikan

String

Huruf kecil yang setara dengan string saat ini.

Contoh

Contoh berikut menentukan array string yang berisi satu kata dalam sejumlah bahasa. Metode ToLowerInvariant 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 kecil untuk memastikan bahwa elemen muncul dalam urutan yang sama terlepas dari bahasa.

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

open System

let words = 
    [| "Tuesday"; "Salı"; "Вторник"; "Mardi" 
       "Τρίτη"; "Martes"; "יום שלישי" 
       "الثلاثاء"; "วันอังคาร" |]
// Display array in unsorted order.
for word in words do
    printfn $"{word}"
printfn ""

// Create parallel array of words by calling ToLowerInvariant.
let lowerWords = 
    words |> Array.map (fun x -> x.ToLowerInvariant())

// Sort the words array based on the order of lowerWords.
Array.Sort(lowerWords, words, StringComparer.InvariantCulture)

// Display the sorted array.
for word in words do
    printfn $"{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
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

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 .ToLowerInvariant Metode ToLowerInvariant ini setara dengan ToLower(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 kecil.

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

• ToUpperInvariant()
• ToLower(CultureInfo)
• ToLower()
• InvariantCulture