String.ToLower Método

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

public:
 System::String ^ ToLower();

public string ToLower();

member this.ToLower : unit -> string

Public Function ToLower () As String

Devoluções

Uma corda em minúsculas.

Exemplos

O exemplo seguinte converte várias cadeias de maiúsculas mistas para minúsculas.

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

Observações

Este método tem em conta as regras de revestimento da cultura atual.

A operação de revestimento que resulta da chamada do ToLower() método tem em conta as convenções de revestimento da cultura atual. Se precisar da versão minúscula ou maiúscula de um identificador do sistema operativo, como um nome de ficheiro, um pipe nomeado ou uma chave de registo, use os ToLowerInvariant métodos ou ToUpperInvariant . Isto produz o mesmo resultado em todas as culturas (ao contrário do ToLower() método) e funciona de forma mais eficiente.

Notas para Chamadores

Como explicado em Melhores Práticas para o Uso de Strings, recomendamos que evite chamar métodos de carcaça de strings que substituem valores padrão e, em vez disso, chamar métodos que exijam especificar explicitamente os parâmetros. Para converter um carácter para minúsculas usando as convenções de carcaça da cultura atual, sinalize explicitamente a sua intenção chamando o ToLower(CultureInfo) método overload com um valor de CurrentCulture para o seu culture parâmetro. Se não precisares de comparação linguísticamente consciente, considera usar Ordinal.

Ver também

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

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

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

Devoluções

O equivalente minúsculo da corda atual.

Exemplos

O exemplo seguinte converte duas cadeias de caracteres maiúsculos em letras minúsculas usando os estados English-United e culturas Turkish-Turkey, depois compara as cadeias minúsculas. As cadeias maiúsculas são idênticas, exceto que, para cada ocorrência da letra maiúscula I latina Unicode numa cadeia, a outra cadeia contém LETRA MAIÚSCULA LATINA I COM PONTO ACIMA.

// 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

Observações

As regras de revestimento da cultura especificadas pelo culture parâmetro determinam a forma como o caso da corda é alterado.

Se passar o ToLower(CultureInfo) método a um CultureInfo objeto diferente de CultureInfo.InvariantCulture, a operação de revestimento terá em conta regras específicas da cultura. Se precisar da versão minúscula ou maiúscula de um identificador do sistema operativo, como um nome de ficheiro, um pipe nomeado ou uma chave de registo, use o ToLowerInvariant método ou ToUpperInvariant . Isto produz o mesmo resultado em todas as culturas e funciona de forma mais eficiente.

Ver também

• CultureInfo
• ToUpper()