TextInfo.ToUpper 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 maiúscula.

Sobrecargas

Nome Description
ToUpper(Char)

Converte o caractere especificado em letras maiúsculas.
ToUpper(String)

Converte a cadeia de caracteres especificada em maiúscula.

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

ToUpper(Char)

Converte o caractere especificado em letras maiúsculas.

public:
 virtual char ToUpper(char c);
public virtual char ToUpper(char c);
abstract member ToUpper : char -> char
override this.ToUpper : char -> char
Public Overridable 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 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

ToUpper(String)

Converte a cadeia de caracteres especificada em maiúscula.

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

Parâmetros

str
String

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

Retornos

String

A cadeia de caracteres especificada convertida em maiúscula.

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