String.ToLowerInvariant Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

String.Manipulation.cs

Zwraca kopię tego String obiektu przekonwertowaną na małe litery przy użyciu reguł wielkości liter niezmiennej kultury.

public:
 System::String ^ ToLowerInvariant();

public string ToLowerInvariant ();

member this.ToLowerInvariant : unit -> string

Public Function ToLowerInvariant () As String

Zwraca

String

Małe litery odpowiadające bieżącemu ciągowi.

Przykłady

W poniższym przykładzie zdefiniowano tablicę ciągów zawierającą pojedyncze słowo w wielu językach. Metoda ToLowerInvariant służy do wypełniania elementów tablicy równoległej wersją każdego wyrazu bez uwzględniania wielkości liter. Metoda Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) służy do sortowania tablicy uwzględniającej wielkość liter na podstawie kolejności elementów w tablicy małych liter, aby upewnić się, że elementy są wyświetlane w tej samej kolejności, niezależnie od języka.

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

Uwagi

Niezmienna kultura reprezentuje kulturę, w której nie uwzględnia się ustawień kulturowych. Jest on skojarzony z językiem angielskim, ale nie z określonym krajem lub regionem. Aby uzyskać więcej informacji, zobacz CultureInfo.InvariantCulture właściwość .

Jeśli aplikacja zależy od przypadku zmiany ciągu w przewidywalny sposób, który nie ma wpływu na bieżącą kulturę, użyj ToLowerInvariant metody . Metoda jest równoważna ToLowerInvariant metodzie ToLower(CultureInfo.InvariantCulture). Metoda jest zalecana, gdy kolekcja ciągów musi być wyświetlana w przewidywalnej kolejności w kontrolce interfejsu użytkownika.

Uwaga

Metoda ta nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie znaki w bieżącym wystąpieniu są konwertowane na małe litery.

Jeśli potrzebujesz małej lub wielkich liter identyfikatora systemu operacyjnego, takiej jak nazwa pliku, nazwany potok lub klucz rejestru, użyj ToLowerInvariant metod lub .ToUpperInvariant

Zobacz też

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