String.ToLowerInvariant Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

String.Manipulation.cs

Devuelve una copia de este String objeto convertido en minúsculas mediante las reglas de mayúsculas y minúsculas de la referencia cultural invariable.

public:
 System::String ^ ToLowerInvariant();

public string ToLowerInvariant();

member this.ToLowerInvariant : unit -> string

Public Function ToLowerInvariant () As String

Devoluciones

String

Equivalente en minúsculas de la cadena actual.

Ejemplos

En el ejemplo siguiente se define una matriz de cadenas que contiene una sola palabra en varios idiomas. El ToLowerInvariant método se usa para rellenar los elementos de una matriz paralela con la versión sin distinción entre mayúsculas y minúsculas de cada palabra. El Array.Sort<TKey,TValue>(TKey[], TValue[], IComparer<TKey>) método se usa para ordenar la matriz que distingue mayúsculas de minúsculas en función del orden de los elementos de la matriz minúscula para asegurarse de que los elementos aparecen en el mismo orden independientemente del idioma.

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

Comentarios

La cultura invariante representa una cultura insensible a variaciones culturales. Está asociado al idioma inglés, pero no a un país o región específicos. Para obtener más información, consulte la propiedad CultureInfo.InvariantCulture.

Si la aplicación depende del caso de un cambio de cadena de una manera predecible que no se ve afectada por la referencia cultural actual, use el ToLowerInvariant método . El ToLowerInvariant método es equivalente a ToLower(CultureInfo.InvariantCulture). Se recomienda el método cuando una colección de cadenas debe aparecer en un orden predecible en un control de interfaz de usuario.

Nota:

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que todos los caracteres de la instancia actual se convierten en minúsculas.

Si necesita la versión en minúsculas o mayúsculas de un identificador de sistema operativo, como un nombre de archivo, una canalización con nombre o una clave del Registro, use los ToLowerInvariant métodos o ToUpperInvariant .

Consulte también

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