TextInfo.ToUpper Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

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

Sobrecargas

ToUpper(Char)	Converte o caractere especificado em maiúsculas.
ToUpper(String)	Converte a cadeia de caracteres especificada em maiú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 de 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

ToUpper(Char)

Origem:

TextInfo.cs

Converte o caractere especificado em maiúsculas.

public:
 char ToUpper(char c);

public char ToUpper (char c);

member this.ToUpper : char -> char

Public Function ToUpper (c As Char) As Char

Parâmetros

c

Char

O caractere a ser convertido em maiúsculas.

Retornos

Char

O caractere especificado é convertido em maiú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 caso, 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 de cultura, como serviços do sistema. Caso contrário, produzirá resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

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

Confira também

• ToLower(Char)
• ToTitleCase(String)

ToUpper(String)

Origem:

TextInfo.cs

Converte a cadeia de caracteres especificada em maiúsculas.

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

public string ToUpper (string str);

member this.ToUpper : string -> string

Public Function ToUpper (str As String) As String

Parâmetros

str

String

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

Retornos

String

A cadeia de caracteres especificada convertida em maiúsculas.

Exceções

ArgumentNullException

str é nulo.

Comentários

A cadeia de caracteres retornada pode ser diferente de 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 Caso", publicado pelo Unicode Consortium (https://www.unicode.org). 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 caso, 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 de cultura, como serviços do sistema. Caso contrário, produzirá resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

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

Confira também

• ToLower(Char)
• ToTitleCase(String)