TextInfo.ToLower Método

Definição

Namespace:
System.Globalization
Assemblies:
mscorlib.dll, System.Globalization.dll
Assembly:
mscorlib.dll
Assembly:
System.Globalization.dll
Assembly:
netstandard.dll

Converte o caractere ou cadeia de caracteres especificado em letras minúsculas.

Sobrecargas

Nome Description
ToLower(Char)

Converte o caractere especificado em letras minúsculas.
ToLower(String)

Converte a cadeia de caracteres especificada em minúsculas.

Exemplos

O exemplo de código a seguir altera a maiúscula de uma cadeia de caracteres com base na cultura em inglês (Estados Unidos), com o nome da cultura en-US.

using System;
using System.Globalization;

public class SamplesTextInfo  {

   public static void Main()  {

      // Defines the string with mixed casing.
      string myString = "wAr aNd pEaCe";

      // Creates a TextInfo based on the "en-US" culture.
      TextInfo myTI = new CultureInfo("en-US",false).TextInfo;

      // Changes a string to lowercase.
      Console.WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI.ToLower( myString ) );

      // Changes a string to uppercase.
      Console.WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI.ToUpper( myString ) );

      // Changes a string to titlecase.
      Console.WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI.ToTitleCase( myString ) );
   }
}

/*
This code produces the following output.

"wAr aNd pEaCe" to lowercase: war and peace
"wAr aNd pEaCe" to uppercase: WAR AND PEACE
"wAr aNd pEaCe" to titlecase: War And Peace

*/

Imports System.Globalization

Public Class SamplesTextInfo

   Public Shared Sub Main()

      ' Defines the string with mixed casing.
      Dim myString As String = "wAr aNd pEaCe"

      ' Creates a TextInfo based on the "en-US" culture.
      Dim myTI As TextInfo = New CultureInfo("en-US", False).TextInfo

      ' Changes a string to lowercase.
      Console.WriteLine("""{0}"" to lowercase: {1}", myString, myTI.ToLower(myString))

      ' Changes a string to uppercase.
      Console.WriteLine("""{0}"" to uppercase: {1}", myString, myTI.ToUpper(myString))

      ' Changes a string to titlecase.
      Console.WriteLine("""{0}"" to titlecase: {1}", myString, myTI.ToTitleCase(myString))

   End Sub

End Class


'This code produces the following output.
'
'"wAr aNd pEaCe" to lowercase: war and peace
'"wAr aNd pEaCe" to uppercase: WAR AND PEACE
'"wAr aNd pEaCe" to titlecase: War And Peace

ToLower(Char)

Converte o caractere especificado em letras minúsculas.

public:
 virtual char ToLower(char c);
public virtual char ToLower(char c);
abstract member ToLower : char -> char
override this.ToLower : char -> char
Public Overridable Function ToLower (c As Char) As Char

Parâmetros

c
Char

O caractere a ser convertido em minúsculas.

Retornos

Char

O caractere especificado convertido em letras minúsculas.

Comentários

A semântica de maiúsculas e minúsculas depende da cultura em uso. Para a cultura invariável, a semântica de maiúsculas e minúsculas não diferencia a cultura. Para uma cultura específica, a semântica de maiúsculas e minúsculas é sensível a essa cultura.

Se uma decisão de segurança depender de uma comparação de cadeia de caracteres ou de uma operação de alteração de maiúsculas e minúsculas, o aplicativo deverá usar InvariantCulture para garantir que o comportamento seja consistente, independentemente das configurações de cultura do sistema. No entanto, a cultura invariável deve ser usada apenas por processos que exigem resultados independentes da cultura, como serviços do sistema. Caso contrário, produz resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

Para obter mais informações sobre culturas, consulte CultureInfo.

Confira também

Aplica-se a

ToLower(String)

Converte a cadeia de caracteres especificada em minúsculas.

public:
 virtual System::String ^ ToLower(System::String ^ str);
public virtual string ToLower(string str);
abstract member ToLower : string -> string
override this.ToLower : string -> string
Public Overridable Function ToLower (str As String) As String

Parâmetros

str
String

A cadeia de caracteres a ser convertida em minúsculas.

Retornos

String

A cadeia de caracteres especificada convertida em minúsculas.

Exceções

ArgumentNullException

str é nulo.

Comentários

A cadeia de caracteres retornada pode diferir em comprimento da cadeia de caracteres de entrada. Para obter mais informações sobre maiúsculas e minúsculas, consulte o Relatório Técnico Unicode nº 21 "Mapeamentos de Casos", publicado pelo Consórcio Unicode. A implementação atual preserva o comprimento da cadeia de caracteres. No entanto, esse comportamento não é garantido e pode mudar em implementações futuras.

A semântica de maiúsculas e minúsculas depende da cultura em uso. Para a cultura invariável, a semântica de maiúsculas e minúsculas não diferencia a cultura. Para uma cultura específica, a semântica de maiúsculas e minúsculas é sensível a essa cultura.

Se uma decisão de segurança depender de uma comparação de cadeia de caracteres ou de uma operação de alteração de maiúsculas e minúsculas, o aplicativo deverá usar InvariantCulture para garantir que o comportamento seja consistente, independentemente das configurações de cultura do sistema. No entanto, a cultura invariável deve ser usada apenas por processos que exigem resultados independentes da cultura, como serviços do sistema. Caso contrário, produz resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

Para obter mais informações sobre culturas, consulte CultureInfo.

Confira também

Aplica-se a