String.ToLowerInvariant Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

String.Manipulation.cs

Devuelve una copia de este objeto String convertido en minúsculas, aplicando las reglas de mayúsculas y minúsculas de la referencia cultural de todos los idiomas.

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 con distinción entre mayúsculas y 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 referencia cultural invariable representa una referencia cultural que no distingue la referencia cultural. Está asociado con el idioma inglés, pero no con un país o región específicos. Para obtener más información, vea la propiedad CultureInfo.InvariantCulture.

Si la aplicación depende del caso de que una cadena cambie de una manera predecible que no se vea afectada por la referencia cultural actual, use el ToLowerInvariant método . El ToLowerInvariant método es equivalente a ToLower(CultureInfo.InvariantCulture). El método se recomienda 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 minúscula o mayúscula 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