C# String ToUpper

Resumo : neste tutorial, você aprenderá como usar o ToUpper()método C# String para converter uma string em maiúsculas.

Introdução ao método C# ToUpper()

O método String ToUpper() retorna uma cópia da string atual convertida em maiúsculas. Aqui está a sintaxe do ToUpper()método:

public string ToUpper();Linguagem de código:  PHP  ( php )

O exemplo a seguir usa o ToUpper()método para converter a mensagem "Hello, World!"em maiúsculas:

using static System.Console;

var message = "Hello, World!";
var upper = message.ToUpper();

WriteLine(upper);Linguagem de código:  C#  ( cs )

Saída:

HELLO, WORLD!Linguagem de código:  texto simples  ( texto simples )

Por padrão, o ToUpper()método leva a regra de caso da cultura atual para a conversão. Mas se você quiser converter uma string para maiúscula usando uma cultura específica, você pode usar a seguinte sobrecarga do ToUpper()método:

public string ToLower (
   System.Globalization.CultureInfo? culture
);Linguagem de código:  C#  ( cs )

Nesta sintaxe, the cultureé uma instância CultureInfoque especifica uma regra de maiúsculas e minúsculas específica da cultura.

Por exemplo, o programa a seguir ilustra como usar CultureInfoobjetos diferentes pode levar a diferentes conversões de letras maiúsculas com base em regras de idioma específicas:

using System.Globalization;
using static System.Console;
var s = "istanbul İzmir Ankara";

// Using the default (English) culture
var englishUppercase = s.ToUpper(CultureInfo.InvariantCulture);
WriteLine("Default (English) uppercase: " + englishUppercase);

// Using the Turkish culture
var turkishCulture = new CultureInfo("tr-TR");
var turkishUppercase = s.ToUpper(turkishCulture);
WriteLine("Turkish uppercase: " + turkishUppercase);Linguagem de código:  C#  ( cs )

Neste exemplo, temos uma string que contém caracteres turcos, como "İ"(maiúsculo İcom ponto) e "İ"(pequeno icom ponto), que são específicos do alfabeto turco.

Quando usamos o ToUpper()para converter uma string em maiúsculas usando a cultura padrão (inglês), o método usa as regras do inglês para conversão de maiúsculas e obtemos "ISTANBUL İZMIR ANKARA".

No entanto, quando usamos o ToUpper()método com a cultura turca ( "tr-TR"), o método usa regras de letras maiúsculas específicas do turco para conversão.

Em turco, o equivalente maiúsculo "i"é "İ"sem ponto e o equivalente maiúsculo "İ"é "I"(I maiúsculo sem ponto). Como resultado, a string turca em maiúsculas torna-se "İSTANBUL İZMİR ANKARA".

String C#ToUpperInvariant()

A String ToUpperInvariant()retorna uma versão em maiúscula de uma string usando as regras de maiúsculas e minúsculas da cultura invariável.

Aqui está a sintaxe do ToUpperInvariant()método:

public string ToUpperInvariant();Linguagem de código:  PHP  ( php )

O ToUpperInvariant()método é equivalente ao ToUpper()método com o CultureInfo.InvariantCultureargumento:

ToUpper(CultureInfo.InvariantCulture)Linguagem de código:  CSS  ( css )

Um exemplo prático de uso do ToUpperInvariant()método é quando você precisa realizar uma comparação de strings com distinção entre maiúsculas e minúsculas.

O uso ToUpperInvariant()garante um comportamento consistente e evita possíveis problemas com regras específicas da cultura.

Resumo

• Use o método C# String ToUpper()para converter uma string em maiúsculas.