TextInfo.ToUpper Método

  • Referência

Definição

Namespace:
System.Globalization
Assembly:
System.Globalization.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.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
Origem:
TextInfo.cs
Origem:
TextInfo.cs

Converte o caractere especificado em maiúsculas.

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

Aplica-se a

ToUpper(String)

Origem:
TextInfo.cs
Origem:
TextInfo.cs
Origem:
TextInfo.cs

Converte a cadeia de caracteres especificada em maiúsculas.

public:
 virtual System::String ^ ToUpper(System::String ^ str);
public:
 System::String ^ ToUpper(System::String ^ str);
public virtual string ToUpper (string str);
public string ToUpper (string str);
abstract member ToUpper : string -> string
override this.ToUpper : string -> string
member this.ToUpper : string -> string
Public Overridable Function ToUpper (str As String) As 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

Aplica-se a