TextInfo.ToUpper Método

Definição

Espaço de Nomes:
System.Globalization
Assemblagens:
mscorlib.dll, System.Globalization.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Globalization.dll
Assemblagem:
netstandard.dll

Converte o carácter ou cadeia especificado em maiúsculas.

Sobrecargas

Name Description
ToUpper(Char)

Converte o carácter especificado em maiúsculas.
ToUpper(String)

Converte a sequência especificada em maiúsculas.

Exemplos

O seguinte exemplo de código altera o revestimento de uma corda com base na cultura inglesa (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 carácter especificado em 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 carácter a converter para maiúsculas.

Devoluções

Char

O carácter especificado foi convertido para maiúsculas.

Observações

A semântica da carcaça depende da cultura em uso. Para a cultura invariante, a semântica do revestimento não é sensível à cultura. Para uma cultura específica, a semântica do revestimento é sensível a essa cultura.

Se uma decisão de segurança depender de uma comparação de cadeias ou de uma operação de mudança de caso, a aplicação deve usar o InvariantCulture para garantir que o comportamento é consistente independentemente das definições culturais do sistema. No entanto, a cultura invariante deve ser usada apenas por processos que requerem resultados independentes da cultura, como os serviços do sistema. Caso contrário, produz resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

Para mais informações sobre culturas, veja CultureInfo.

Ver também

Aplica-se a

ToUpper(String)

Converte a sequência especificada em maiúsculas.

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 corda a converter para maiúsculas.

Devoluções

String

A corda especificada convertida em maiúsculas.

Exceções

ArgumentNullException

str é null.

Observações

A corda devolvida pode diferir em comprimento da sequência de entrada. Para mais informações sobre o revestimento, consulte o Relatório Técnico Unicode #21 "Case Mappings", publicado pelo Consórcio Unicode (https://www.unicode.org). A implementação atual preserva o comprimento da cadeia. No entanto, este comportamento não é garantido e pode mudar em implementações futuras.

A semântica da carcaça depende da cultura em uso. Para a cultura invariante, a semântica do revestimento não é sensível à cultura. Para uma cultura específica, a semântica do revestimento é sensível a essa cultura.

Se uma decisão de segurança depender de uma comparação de cadeias ou de uma operação de mudança de caso, a aplicação deve usar o InvariantCulture para garantir que o comportamento é consistente independentemente das definições culturais do sistema. No entanto, a cultura invariante deve ser usada apenas por processos que requerem resultados independentes da cultura, como os serviços do sistema. Caso contrário, produz resultados que podem ser linguisticamente incorretos ou culturalmente inadequados.

Para mais informações sobre culturas, veja CultureInfo.

Ver também

Aplica-se a