Char.ToUpper Método

Definição

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

Converte o valor de um carácter Unicode para o seu equivalente maiúsculo.

Sobrecargas

Name Description
ToUpper(Char, CultureInfo)

Converte o valor de um carácter Unicode especificado para o seu equivalente maiúsculo usando informação de formatação específica para cultura.
ToUpper(Char)

Converte o valor de um carácter Unicode para o 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 carácter Unicode especificado para o seu equivalente maiúsculo usando informação de formatação específica para cultura.

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 carácter Unicode a converter.

culture
CultureInfo

Um objeto que forneça regras de revestimento específicas de cada cultura.

Devoluções

Char

O equivalente maiúsculo de c, modificado de acordo com culture, ou o valor inalterado de c se c já for maiúsculo, não tiver equivalente maiúsculo, ou não for alfabético.

Exceções

ArgumentNullException

culture é null.

Exemplos

O exemplo seguinte converte cada carácter num array para o seu equivalente maiúsculo para a cultura en-US, a cultura invariante e a cultura tr-TR. Neste exemplo, o equivalente maiúsculo de cada letra minúscula é idêntico para todas as culturas, exceto para um caso. O carácter minúsculo "i" (U+0069) converte-se em "I" (U+0049) nas culturas en-US e invariantes, 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

Observações

Use String.ToUpper para converter uma corda em maiúscula.

Ver 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 carácter Unicode para o 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 carácter Unicode a converter.

Devoluções

Char

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

Exemplos

O exemplo seguinte converte cada carácter de um array para o 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)
'       ж --> Ж
'       ä --> Ä

Observações

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

Use String.ToUpper para converter uma corda em maiúscula.

Notas para Chamadores

Como explicado em Best Practices for Using Strings, recomendamos que evite chamar métodos de character-maiúscula e string-maiing que substituam valores padrão. Em vez disso, deve chamar métodos que exigem especificação explícita dos parâmetros. Para converter um carácter em maiúsculas usando as convenções de carcaça da cultura atual, chame o ToUpper(Char, CultureInfo) método overload com um valor de CurrentCulture para o seu culture parâmetro.

Ver também

Aplica-se a