Char.ToUpper Método

Definição

Namespace:
System
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Assemblies:
mscorlib.dll, System.Runtime.dll

Converte o valor de um caractere Unicode em seu equivalente maiúsculo.

Sobrecargas

Nome Description
ToUpper(Char, CultureInfo)

Converte o valor de um caractere Unicode especificado em seu equivalente maiúsculo usando informações de formatação específicas da cultura especificadas.
ToUpper(Char)

Converte o valor de um caractere Unicode em seu equivalente maiúsculo.

ToUpper(Char, CultureInfo)

Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs

Converte o valor de um caractere Unicode especificado em seu equivalente maiúsculo usando informações de formatação específicas da cultura especificadas.

public:
 static char ToUpper(char c, System::Globalization::CultureInfo ^ culture);
public static char ToUpper(char c, System.Globalization.CultureInfo culture);
static member ToUpper : char * System.Globalization.CultureInfo -> char
Public Shared Function ToUpper (c As Char, culture As CultureInfo) As Char

Parâmetros

c
Char

O caractere Unicode a ser convertido.

culture
CultureInfo

Um objeto que fornece regras de maiúsculas e minúsculas específicas da cultura.

Retornos

Char

O equivalente maiúsculo de c, modificado de acordo culturecom , ou o valor inalterado de c se c já estiver em maiúscula, não tem equivalente maiúsculo ou não é alfabético.

Exceções

ArgumentNullException

culture é null.

Exemplos

O exemplo a seguir converte cada caractere em uma matriz em seu equivalente maiúsculo para a cultura en-US, a cultura invariável e a cultura tr-TR. Neste exemplo, o equivalente maiúsculo de cada letra minúscula é idêntico a todas as culturas, exceto por um caso. O caractere "i" minúsculo (U+0069) converte em "I" (U+0049) nas culturas en-US e invariáveis, mas em "İ" (U+0130) na cultura tr-TR.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo[] cultures= { CultureInfo.CreateSpecificCulture("en-US"),
                                CultureInfo.InvariantCulture,
                                CultureInfo.CreateSpecificCulture("tr-TR") };
      Char[] chars = {'ä', 'e', 'E', 'i', 'I' };

      Console.WriteLine("Character     en-US     Invariant     tr-TR");
      foreach (var ch in chars) {
         Console.Write("    {0}", ch);
         foreach (var culture in cultures)
            Console.Write("{0,12}", Char.ToUpper(ch, culture));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Character     en-US     Invariant     tr-TR
//           ä           Ä           Ä           Ä
//           e           E           E           E
//           E           E           E           E
//           i           I           I           İ
//           I           I           I           I

open System
open System.Globalization

let cultures= 
    [ CultureInfo.CreateSpecificCulture "en-US"
      CultureInfo.InvariantCulture
      CultureInfo.CreateSpecificCulture "tr-TR" ]

let chars = [| 'ä'; 'e'; 'E'; 'i'; 'I' |]

printfn "Character     en-US     Invariant     tr-TR"
for ch in chars do
    printf $"    {ch}"
    for culture in cultures do
        printf $"{Char.ToUpper(ch, culture),12}"
    printfn ""


// The example displays the following output:
//       Character     en-US     Invariant     tr-TR
//           ä           Ä           Ä           Ä
//           e           E           E           E
//           E           E           E           E
//           i           I           I           İ
//           I           I           I           I

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultures() As CultureInfo = { CultureInfo.CreateSpecificCulture("en-US"), 
                                        CultureInfo.InvariantCulture, 
                                        CultureInfo.CreateSpecificCulture("tr-TR") }
      Dim chars() As Char = {"ä"c, "e"c, "E"c, "i"c, "I"c }

      Console.WriteLine("Character     en-US     Invariant     tr-TR")
      For Each ch In chars
         Console.Write("    {0}", ch)
         For Each culture In cultures
            Console.Write("{0,12}", Char.ToUpper(ch, culture))
         Next
         Console.WriteLine()
      Next   
   End Sub
End Module
' The example displays the following output:
'       Character     en-US     Invariant     tr-TR
'           ä           Ä           Ä           Ä
'           e           E           E           E
'           E           E           E           E
'           i           I           I           İ
'           I           I           I           I

Comentários

Use String.ToUpper para converter uma cadeia de caracteres em maiúsculas.

Confira também

Aplica-se a

ToUpper(Char)

Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs
Origem:
Char.cs

Converte o valor de um caractere Unicode em seu equivalente maiúsculo.

public:
 static char ToUpper(char c);
public static char ToUpper(char c);
static member ToUpper : char -> char
Public Shared Function ToUpper (c As Char) As Char

Parâmetros

c
Char

O caractere Unicode a ser convertido.

Retornos

Char

O equivalente maiúsculo de c, ou o valor inalterado de c se c já está em letras maiúsculas, não tem equivalente maiúsculo ou não é alfabético.

Exemplos

O exemplo a seguir converte cada caractere em uma matriz em seu equivalente maiúsculo.

using System;

public class Example
{
   public static void Main()
   {
      char[] chars = { 'e', 'E', '6', ',', 'ж', 'ä' };
      foreach (var ch in chars)
          Console.WriteLine("{0} --> {1} {2}", ch, Char.ToUpper(ch),
                            ch == Char.ToUpper(ch) ? "(Same Character)" : "" );
   }
}
// The example displays the following output:
//       e --> E
//       E --> E (Same Character)
//       6 --> 6 (Same Character)
//       , --> , (Same Character)
//       ж --> Ж
//       ä --> Ä

open System

let chars = [| 'e'; 'E'; '6'; ','; 'ж'; 'ä' |]

for ch in chars do
    printfn $"""{ch} --> {Char.ToUpper ch} {if ch = Char.ToUpper ch then "(Same Character)" else ""}"""

// The example displays the following output:
//       e --> E
//       E --> E (Same Character)
//       6 --> 6 (Same Character)
//       , --> , (Same Character)
//       ж --> Ж
//       ä --> Ä

Module Example
   Public Sub Main()
      Dim chars() As Char = { "e"c, "E"c, "6"c, ","c, "ж"c, "ä"c }
      For Each ch In chars
         Console.WriteLine("{0} --> {1} {2}", ch, Char.ToUpper(ch),
                           If(ch = Char.ToUpper(ch), "(Same Character)", ""))
      Next
   End Sub
End Module
' The example displays the following output:
'       e --> E
'       E --> E (Same Character)
'       6 --> 6 (Same Character)
'       , --> , (Same Character)
'       ж --> Ж
'       ä --> Ä

Comentários

As regras de casing são obtidas da cultura atual.

Use String.ToUpper para converter uma cadeia de caracteres em maiúsculas.

Notas aos Chamadores

Conforme explicado nas práticas recomendadas para o uso de cadeias de caracteres, recomendamos que você evite chamar métodos de caractere-casing e cadeia de caracteres que substituem valores padrão. Em vez disso, você deve chamar métodos que exigem que os parâmetros sejam especificados explicitamente. Para converter um caractere em letras maiúsculas usando as convenções de maiúsculas da cultura atual, chame a sobrecarga do ToUpper(Char, CultureInfo) método com um valor de CurrentCulture seu culture parâmetro.

Confira também

Aplica-se a