String.ToLowerInvariant Méthode

Définition

Retourne une copie de cet objet String converti en minuscules à l'aide des règles de casse de la culture indifférente.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

Retours

Équivalent en minuscules de la chaîne actuelle.The lowercase equivalent of the current string.

Exemples

L’exemple suivant définit un tableau de chaînes qui contient un mot unique dans un certain nombre de langages.The following example defines a string array that contains a single word in a number of languages. La méthode ToLowerInvariant est utilisée pour remplir les éléments d’un tableau parallèle avec la version ne respectant pas la casse de chaque mot.The ToLowerInvariant method is used to populate the elements of a parallel array with the case-insensitive version of each word. La méthode Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) est utilisée pour trier le tableau qui respecte la casse en fonction de l’ordre des éléments dans le tableau en minuscules pour garantir que les éléments apparaissent dans le même ordre, quelle que soit la langue.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
'       Τρίτη
'       Вторник
'       יום שלישי
'       الثلاثاء
'       วันอังคาร

Remarques

La culture dite indifférente représente une culture qui est indépendante de la culture.The invariant culture represents a culture that is culture-insensitive. Il est associé à la langue anglaise, mais pas à un pays ou une région spécifique.It is associated with the English language but not with a specific country or region. Pour plus d'informations, consultez la propriété CultureInfo.InvariantCulture.For more information, see the CultureInfo.InvariantCulture property.

Si votre application dépend de la casse d’une chaîne qui change de façon prévisible et qui n’est pas affectée par la culture actuelle, utilisez la méthode ToLowerInvariant.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. La méthode ToLowerInvariant est équivalente à ToLower(CultureInfo.InvariantCulture).The ToLowerInvariant method is equivalent to 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.The method is recommended when a collection of strings must appear in a predictable order in a user interface control.

Notes

Cette méthode ne modifie pas la valeur de l’instance actuelle.This method does not modify the value of the current instance. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de l’instance actuelle sont convertis en minuscules.Instead, it returns a new string in which all characters in the current instance are converted to lowercase.

Considérations relatives à la sécuritéSecurity Considerations

Si vous avez besoin de la version en minuscules ou en 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 méthodes ToLowerInvariant ou ToUpperInvariant.If 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.

S’applique à

Voir aussi