String.ToLower Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Devuelve una copia de esta cadena convertida en minúsculas.

Sobrecargas

ToLower()	Devuelve una copia de esta cadena convertida en minúsculas.
ToLower(CultureInfo)	Devuelve una copia de esta cadena convertida en minúsculas, aplicando las reglas de mayúsculas y minúsculas de la referencia cultural especificada.

ToLower()

Source:

String.Manipulation.cs

Devuelve una copia de esta cadena convertida en minúsculas.

C#

public string ToLower();

Devoluciones

String

Una cadena en minúsculas.

Ejemplos

En el ejemplo siguiente se convierten varias cadenas de mayúsculas y minúsculas mixtas.

C#

using System;

public class ToLowerTest {
    public static void Main() {

        string [] info = {"Name", "Title", "Age", "Location", "Gender"};

        Console.WriteLine("The initial values in the array are:");
        foreach (string s in info)
            Console.WriteLine(s);

        Console.WriteLine("{0}The lowercase of these values is:", Environment.NewLine);

        foreach (string s in info)
            Console.WriteLine(s.ToLower());

        Console.WriteLine("{0}The uppercase of these values is:", Environment.NewLine);

        foreach (string s in info)
            Console.WriteLine(s.ToUpper());
    }
}
// The example displays the following output:
//       The initial values in the array are:
//       Name
//       Title
//       Age
//       Location
//       Gender
//
//       The lowercase of these values is:
//       name
//       title
//       age
//       location
//       gender
//
//       The uppercase of these values is:
//       NAME
//       TITLE
//       AGE
//       LOCATION
//       GENDER

Comentarios

Este método tiene en cuenta las reglas de mayúsculas y minúsculas de la referencia cultural actual.

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.

La operación de uso de mayúsculas y minúsculas que resulta de llamar al ToLower() método toma en cuenta las convenciones de mayúsculas y minúsculas de la referencia cultural actual. 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 . Esto produce el mismo resultado en todas las referencias culturales (a diferencia del ToLower() método) y funciona de forma más eficaz.

Notas a los autores de las llamadas

Como se explica en Procedimientos recomendados para usar cadenas, se recomienda evitar llamar a métodos de mayúsculas y minúsculas de cadena que sustituya los valores predeterminados y, en su lugar, llame a métodos que requieren que se especifiquen explícitamente parámetros. Para convertir un carácter en minúsculas mediante las convenciones de mayúsculas y minúsculas de la referencia cultural actual, indique su intención explícitamente llamando a la sobrecarga del ToLower(CultureInfo) método con un valor de CurrentCulture para su culture parámetro. Si no necesita una comparación con reconocimiento lingüístico, considere la posibilidad de usar Ordinal.

Consulte también

• ToLowerInvariant()
• ToUpper()
• ToUpperInvariant()

ToLower(CultureInfo)

Source:

String.Manipulation.cs

Devuelve una copia de esta cadena convertida en minúsculas, aplicando las reglas de mayúsculas y minúsculas de la referencia cultural especificada.

C#

public string ToLower(System.Globalization.CultureInfo? culture);

Parámetros

culture

CultureInfo

Objeto que proporciona reglas de mayúsculas y minúsculas específicas de la referencia cultural. Si culture es null, se usa la referencia cultural actual.

Devoluciones

String

Equivalente en minúsculas de la cadena actual.

Ejemplos

En el ejemplo siguiente se convierten dos cadenas de caracteres en mayúsculas en caracteres en minúsculas mediante los English-United Estados y Turkish-Turkey referencias culturales y, a continuación, se comparan las cadenas en minúsculas. Las cadenas en mayúsculas son idénticas, salvo que, para cada aparición de la LETRA I MAYÚSCULA LATINA Unicode en una cadena, la otra cadena contiene LETRA MAYÚSCULA LATINA I WITH DOT ABOVE.

C#

// Sample for String.ToLower(CultureInfo)

using System;
using System.Globalization;

class Sample
{
    public static void Main()
    {
    String str1 = "INDIGO";
    // str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
    String str2 = new String(new Char[] {'\u0130', 'N', 'D', '\u0130', 'G', 'O'});
    String str3, str4;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}'", str1);

    Console.WriteLine();
    Console.WriteLine("str1 is {0} to str2.",
         ((0 == String.CompareOrdinal(str1, str2)) ? "equal" : "not equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);

    Console.WriteLine();
    // str3 is a lower case copy of str2, using English-United States culture.
    Console.WriteLine("str3 = Lower case copy of str2 using English-United States culture.");
    str3 = str2.ToLower(new CultureInfo("en-US", false));

    // str4 is a lower case copy of str2, using Turkish-Turkey culture.
    Console.WriteLine("str4 = Lower case copy of str2 using Turkish-Turkey culture.");
    str4 = str2.ToLower(new CultureInfo("tr-TR", false));

    // Compare the code points in str3 and str4.
    Console.WriteLine();
    Console.WriteLine("str3 is {0} to str4.",
         ((0 == String.CompareOrdinal(str3, str4)) ? "equal" : "not equal"));
    CodePoints("str3", str3);
    CodePoints("str4", str4);
    }

    public static void CodePoints(String title, String s)
    {
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title);
    foreach (ushort u in s)
      Console.Write("{0:x4} ", u);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

str1 = 'INDIGO'

str1 is not equal to str2.

The code points in str1 are:
0049 004e 0044 0049 0047 004f

The code points in str2 are:
0130 004e 0044 0130 0047 004f

str3 = Lower case copy of str2 using English-United States culture.
str4 = Lower case copy of str2 using Turkish-Turkey culture.

str3 is equal to str4.

The code points in str3 are:
0069 006e 0064 0069 0067 006f

The code points in str4 are:
0069 006e 0064 0069 0067 006f
*/

Comentarios

Las reglas de mayúsculas y minúsculas de la referencia cultural especificada por el culture parámetro determinan la forma en que se cambia el caso de la cadena.

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 pasa el ToLower(CultureInfo) método un CultureInfo objeto distinto CultureInfo.InvariantCulturede , la operación de uso de mayúsculas y minúsculas tendrá en cuenta las reglas específicas de la referencia cultural. 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 el ToLowerInvariant método o ToUpperInvariant . Esto produce el mismo resultado en todas las referencias culturales y funciona de forma más eficaz.

Consulte también

• CultureInfo
• ToUpper()