TextInfo.ToLower Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

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

Sobrecargas

ToLower(Char)	Converte o caractere especificado em minúsculas.
ToLower(String)	Converte a cadeia de caracteres especificada em minúsculas.

Exemplos

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

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the String* with mixed casing.
   String^ myString = "wAr aNd pEaCe";
   
   // Creates a TextInfo based on the S"en-US" culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   TextInfo^ myTI = MyCI->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.

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

*/

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)

Origem:

TextInfo.cs

Converte o caractere especificado em minúsculas.

public:
 char ToLower(char c);

public char ToLower (char c);

member this.ToLower : char -> char

Public 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 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 uso de maiúsculas e minúsculas não diferencia a cultura. Para uma cultura específica, a semântica de uso 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 o 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, ele produzirá resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

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

Confira também

• ToUpper(Char)
• ToTitleCase(String)

ToLower(String)

Origem:

TextInfo.cs

Converte a cadeia de caracteres especificada em minúsculas.

public:
 System::String ^ ToLower(System::String ^ str);

public string ToLower (string str);

member this.ToLower : string -> string

Public 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 Maiúsculas e Minúsculas", publicado pelo Unicode Consortium. 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 uso de maiúsculas e minúsculas não diferencia a cultura. Para uma cultura específica, a semântica de uso 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 o 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, ele produzirá resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

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

Confira também

• ToUpper(Char)
• ToTitleCase(String)