String.ToLowerInvariant Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une copie de cet objet String converti en minuscules à l'aide des règles de casse de la culture indifférente.
public:
System::String ^ ToLowerInvariant();
public string ToLowerInvariant ();
member this.ToLowerInvariant : unit -> string
Public Function ToLowerInvariant () As String
Retours
Équivalent en minuscules de la chaîne actuelle.
Exemples
L’exemple suivant définit un tableau de chaînes qui contient un seul mot dans plusieurs langues. La ToLowerInvariant méthode est utilisée pour remplir les éléments d’un tableau parallèle avec la version qui ne respecte pas la casse de chaque mot. La Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) méthode est utilisée pour trier le tableau respectant la casse en fonction de l’ordre des éléments dans le tableau minuscule afin de s’assurer que les éléments apparaissent dans le même ordre, quelle que soit la langue.
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
' Τρίτη
' Вторник
' יום שלישי
' الثلاثاء
' วันอังคาร
Remarques
La culture invariante représente une culture qui ne tient pas compte de la culture. Il est associé à la langue anglaise, mais pas à un pays ou une région spécifique. Pour plus d'informations, consultez la propriété CultureInfo.InvariantCulture.
Si votre application dépend du cas d’une chaîne qui change d’une manière prévisible qui n’est pas affectée par la culture actuelle, utilisez la ToLowerInvariant méthode . La ToLowerInvariant méthode est équivalente à ToLower(CultureInfo.InvariantCulture)
. La méthode est recommandée lorsqu’une collection de chaînes doit apparaître dans un ordre prévisible dans un contrôle d’interface utilisateur.
Notes
Cette méthode ne modifie pas la valeur de la instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de la instance actuelle sont convertis en minuscules.
Si vous avez besoin de la version en minuscules ou majuscules d’un identificateur de système d’exploitation, par exemple un nom de fichier, un canal nommé ou une clé de Registre, utilisez les ToLowerInvariant méthodes ou ToUpperInvariant .