String.ToLowerInvariant Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

String.Manipulation.cs

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 ToLowerInvariant -Methode wird verwendet, um die Elemente eines parallelen Arrays mit der version ohne Beachtung der Groß-/Kleinschreibung jedes Worts aufzufüllen. Die Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) -Methode wird verwendet, um das Array zu sortieren, das die Groß-/Kleinschreibung berücksichtigt, basierend auf der Reihenfolge der Elemente im Kleinbuchstabenarray, um sicherzustellen, dass Elemente unabhängig von der Sprache in derselben 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
//       Τρίτη
//       Вторник
//       יום שלישי
//       الثلاثاء
//       วันอังคาร

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

Hinweise

Die invariante Kultur stellt eine Kultur dar, die kulturunabhängig ist. Es ist der englischen Sprache zugeordnet, aber nicht mit 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, ob 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ächensteuerelement angezeigt werden muss.

Hinweis

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

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

Weitere Informationen

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