String.ToLowerInvariant Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

String.Manipulation.cs

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

public:
 System::String ^ ToLowerInvariant();

public string ToLowerInvariant();

member this.ToLowerInvariant : unit -> string

Public Function ToLowerInvariant () As String

Návraty

String

Malá písmena odpovídající aktuálnímu řetězci.

Příklady

Následující příklad definuje pole řetězců, které obsahuje jedno slovo v řadě jazyků. Metoda ToLowerInvariant se používá k naplnění prvků paralelního pole verzí každého slova bez rozlišování malých a velkých písmen. Metoda Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) se používá k řazení pole s rozlišováním velkých a malých písmen 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í kultura představuje kulturu, která není závislá na kulturních rozdílech. Je přidružen k anglickému jazyku, ale ne ke konkrétní zemi nebo oblasti. Další informace najdete ve vlastnosti CultureInfo.InvariantCulture.

Pokud vaše aplikace závisí na případě změny řetězce předvídatelným způsobem, který není ovlivněn aktuální jazykovou verzí, použijte metodu ToLowerInvariant . Metoda ToLowerInvariant je ekvivalentní ToLower(CultureInfo.InvariantCulture). Tato metoda se doporučuje, když se kolekce řetězců musí v ovládacím prvku uživatelského rozhraní objevit 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 malá nebo velká písmena identifikátoru operačního systému, například název souboru, pojmenovaný kanál nebo klíč registru, použijte ToLowerInvariant metody nebo ToUpperInvariant metody.

Viz také

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