String.ToLowerInvariant Methode

Definition

Gibt eine in Kleinbuchstaben konvertierte Kopie dieses String -Objekts zurück, wobei die Regeln der Groß- und Kleinschreibung der invarianten Kultur verwendet werden.

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

Gibt zurück

String

Die Entsprechung der aktuellen Zeichenfolge in Kleinbuchstaben.

Beispiele

Im folgenden Beispiel wird ein Zeichenfolgenarray definiert, das ein einzelnes Wort in einer Reihe von Sprachen enthält. Die -Methode wird verwendet, um die Elemente eines parallelen Arrays mit der Version jedes Worts zu füllen, bei der die ToLowerInvariant Groß-/Kleinschreibung nicht beachtet wird. Die -Methode wird verwendet, um das Array, bei dem die Groß-/Kleinschreibung beachtet wird, basierend auf der Reihenfolge der Elemente im Kleinbuchstabenarray zu sortieren, um sicherzustellen, dass Elemente unabhängig von der Sprache in der Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) gleichen Reihenfolge angezeigt werden.

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

Hinweise

Die invariante Kultur stellt eine Kultur dar, die kulturunabhängig ist. Sie ist der englischen Sprache zugeordnet, aber nicht einem bestimmten Land oder einer bestimmten Region. Weitere Informationen finden Sie in den Ausführungen zur CultureInfo.InvariantCulture-Eigenschaft.

Wenn Ihre Anwendung davon abhängt, dass sich eine Zeichenfolge auf vorhersagbare Weise ändert, die von der aktuellen Kultur nicht betroffen ist, verwenden Sie die ToLowerInvariant -Methode. Die ToLowerInvariant -Methode entspricht ToLower(CultureInfo.InvariantCulture) . Die -Methode wird empfohlen, wenn eine Auflistung von Zeichenfolgen in einer vorhersagbaren Reihenfolge in einem Benutzeroberflächen-Steuerelement angezeigt werden muss.

Hinweis

Diese Methode ändert den Wert der aktuellen Instanz nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Zeichen in der aktuellen Instanz in Kleinbuchstaben konvertiert werden.

Sicherheitsüberlegungen

Wenn Sie die Klein- oder Großbuchstabenversion eines Betriebssystembezeichners benötigen, z. B. einen Dateinamen, eine Named Pipe oder einen Registrierungsschlüssel, verwenden Sie die ToLowerInvariant Methoden oder ToUpperInvariant .

Gilt für

Siehe auch