String.ToLowerInvariant Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

String.Manipulation.cs

Vrátí kopii tohoto String objektu převedenou na malá písmena pomocí pravidel pro velká a malá písmena invariantní jazykové verze.

public:
 System::String ^ ToLowerInvariant();

public string ToLowerInvariant ();

member this.ToLowerInvariant : unit -> string

Public Function ToLowerInvariant () As String

Návraty

String

Ekvivalent aktuálního řetězce malými písmeny

Příklady

Následující příklad definuje pole řetězců, které obsahuje jedno slovo v několika jazycích. Metoda ToLowerInvariant se používá k naplnění prvků paralelního pole verzí každého slova, která nerozlišují malá a velká písmena. Metoda Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) se používá k řazení pole rozlišující malá a velká písmena na základě pořadí prvků v poli malými písmeny, aby se zajistilo, že se prvky zobrazí ve stejném pořadí bez ohledu na jazyk.

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

Poznámky

Invariantní jazyková verze představuje jazykovou verzi, která není závislá na jazykové verzi. Je přidružený k anglickému jazyku, ale ne ke konkrétní zemi nebo oblasti. Další informace najdete ve CultureInfo.InvariantCulture vlastnosti .

Pokud vaše aplikace závisí na případu, kdy se řetězec mění předvídatelným způsobem, který není aktuální jazykovou verzí ovlivněn, použijte metodu ToLowerInvariant . Metoda ToLowerInvariant je ekvivalentní metodě ToLower(CultureInfo.InvariantCulture). Metoda se doporučuje, když se kolekce řetězců musí v ovládacím prvku uživatelského rozhraní zobrazovat v předvídatelným pořadí.

Poznámka

Tato metoda neupravuje hodnotu aktuální instance. Místo toho vrátí nový řetězec, ve kterém jsou všechny znaky v aktuální instanci převedeny na malá písmena.

Pokud potřebujete verzi identifikátoru operačního systému malými nebo velkými písmeny, například název souboru, pojmenovaný kanál nebo klíč registru, použijte ToLowerInvariant metody nebo ToUpperInvariant .

Viz také

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