String.ToLower Método

Definición

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

Sobrecargas

Nombre Description
ToLower()

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

ToLower(CultureInfo)

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

ToLower()

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

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

public:
 System::String ^ ToLower();
public string ToLower();
member this.ToLower : unit -> string
Public Function ToLower () As String

Devoluciones

Cadena en minúsculas.

Ejemplos

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

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
open System

let info = [| "Name"; "Title"; "Age"; "Location"; "Gender" |]

printfn "The initial values in the array are:"
for s in info do
    printfn $"{s}"

printfn $"{Environment.NewLine}The lowercase of these values is:"

for s in info do
    printfn $"{s.ToLower()}"

printfn $"{Environment.NewLine}The uppercase of these values is:"

for s in info do
    printfn $"{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
Dim info As String() = {"Name", "Title", "Age", "Location", "Gender"}

Console.WriteLine("The initial values in the array are:")

Dim s As String
For Each s In info
    Console.WriteLine(s)
Next

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

For Each s In info
    Console.WriteLine(s.ToLower())
Next

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

For Each s In info
    Console.WriteLine(s.ToUpper())
Next

' 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.

Note

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 resultante 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 llame a métodos que requieren que se especifiquen explícitamente los 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

Se aplica a

ToLower(CultureInfo)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

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

public:
 System::String ^ ToLower(System::Globalization::CultureInfo ^ culture);
public string ToLower(System.Globalization.CultureInfo? culture);
public string ToLower(System.Globalization.CultureInfo culture);
member this.ToLower : System.Globalization.CultureInfo -> string
Public Function ToLower (culture As CultureInfo) As String

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

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 estados de English-United 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 MAYÚSCULA UNICODE I en una cadena, la otra cadena contiene LA LETRA MAYÚSCULA LATINA I WITH DOT ABOVE.

// 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
*/
// Sample for String.ToLower(CultureInfo)

open System
open System.Globalization

let codePoints title s =
     printf $"{Environment.NewLine}The code points in {title} are: {Environment.NewLine}"
     for u in s do
          printf $"{u:x4} "
     printfn ""

let str1 = "INDIGO"
// str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
let str2 = String [| '\u0130'; 'N'; 'D'; '\u0130'; 'G'; 'O' |]

printfn $"\nstr1 = '{str1}'\n"

printfn $"""str1 is {if 0 = String.CompareOrdinal(str1, str2) then "equal" else "not equal"} to str2."""
codePoints "str1" str1
codePoints "str2" str2

// str3 is a lower case copy of str2, using English-United States culture.
printfn "\nstr3 = Lower case copy of str2 using English-United States culture."
let str3 = str2.ToLower(CultureInfo("en-US", false))

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

// Compare the code points in str3 and str4.
printfn $"""\nstr3 is {if 0 = String.CompareOrdinal(str3, str4) then "equal" else "not equal"} to str4."""
     
codePoints "str3" str3
codePoints "str4" str4

(*
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
*)
Public Shared Sub Run()
    Dim str1 As [String] = "INDIGO"
    ' str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
    Dim str2 As New [String](New [Char]() {ChrW(&H130), "N"c, "D"c, ChrW(&H130), "G"c, "O"c})
    Dim str3, str4 As [String]

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

    Console.WriteLine()
    Console.WriteLine("str1 is {0} to str2.",
                     IIf(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.",
                     IIf(0 = [String].CompareOrdinal(str3, str4), "equal", "not equal"))
    CodePoints("str3", str3)
    CodePoints("str4", str4)
End Sub

Public Shared Sub CodePoints(title As [String], s As [String])
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title)
    Dim c As Char
    For Each c In s
        Console.Write("{0:x4} ", AscW(c))
    Next c
    Console.WriteLine()
End Sub

'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.

Note

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 conversión 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

Se aplica a