String.ToLowerInvariant String.ToLowerInvariant String.ToLowerInvariant String.ToLowerInvariant Method

Definicja

Zwraca kopię tego String obiektu przekonwertowaną na małe litery przy użyciu reguł wielkości liter dla niezmiennej kultury.Returns a copy of this String object converted to lowercase using the casing rules of the invariant culture.

public:
 System::String ^ ToLowerInvariant();
public string ToLowerInvariant ();
member this.ToLowerInvariant : unit -> string
Public Function ToLowerInvariant () As String

Zwraca

Odpowiednik małymi literami bieżącego ciągu.The lowercase equivalent of the current string.

Przykłady

W poniższym przykładzie zdefiniowano tablicę ciągów, która zawiera pojedynczy wyraz w wielu językach.The following example defines a string array that contains a single word in a number of languages. ToLowerInvariant Metoda jest używana do wypełniania elementów tablicy równoległej bez uwzględniania wielkości liter każdego wyrazu.The ToLowerInvariant method is used to populate the elements of a parallel array with the case-insensitive version of each word. Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) Metoda jest używana do sortowania tablicy z uwzględnieniem wielkości liter na podstawie kolejności elementów w tablicy małych liter, aby zapewnić, że elementy są wyświetlane w tej samej kolejności, niezależnie od języka.The Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) method is used to sort the case-sensitive array based on the order of elements in the lowercase array to ensure that elements appear in the same order regardless of language.

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
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร
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.The invariant culture represents a culture that is culture-insensitive. Jest ona skojarzona z językiem angielskim, ale nie z określonym krajem lub regionem.It is associated with the English language but not with a specific country or region. Aby uzyskać więcej informacji, zobacz CultureInfo.InvariantCulture właściwość.For more information, see the CultureInfo.InvariantCulture property.

Jeśli aplikacja jest zależna od wielkości liter zmiany ciągu w przewidywalny sposób, który nie ma wpływu na bieżącą kulturę, użyj ToLowerInvariant metody.If your application depends on the case of a string changing in a predictable way that is unaffected by the current culture, use the ToLowerInvariant method. Metoda jest równoważna z ToLower(CultureInfo.InvariantCulture). ToLowerInvariantThe ToLowerInvariant method is equivalent to ToLower(CultureInfo.InvariantCulture). Metoda jest zalecana, gdy kolekcja ciągów musi znajdować się w przewidywalnej kolejności w kontrolce interfejsu użytkownika.The method is recommended when a collection of strings must appear in a predictable order in a user interface control.

Uwaga

Metoda ta nie modyfikuje wartości bieżącego wystąpienia.This method does not modify the value of the current instance. Zamiast tego zwraca nowy ciąg, w którym wszystkie znaki w bieżącym wystąpieniu są konwertowane na małe litery.Instead, it returns a new string in which all characters in the current instance are converted to lowercase.

Zagadnienia dotyczące zabezpieczeńSecurity Considerations

Jeśli potrzebujesz małej lub Wielkiej litery identyfikatora systemu operacyjnego, takiego jak nazwa pliku, potok nazwany lub klucz rejestru, użyj ToLowerInvariant metod lub. ToUpperInvariantIf you need the lowercase or uppercase version of an operating system identifier, such as a file name, named pipe, or registry key, use the ToLowerInvariant or ToUpperInvariant methods.

Dotyczy

Zobacz też