Char.ToUpper Método

Definição

Converte o valor de um caractere Unicode para seu equivalente em maiúsculas.Converts the value of a Unicode character to its uppercase equivalent.

Sobrecargas

ToUpper(Char, CultureInfo)

Converte o valor de um caractere Unicode especificado em seu equivalente em letras maiúsculas usando as informações de formatação específicas à cultura especificadas.Converts the value of a specified Unicode character to its uppercase equivalent using specified culture-specific formatting information.

ToUpper(Char)

Converte o valor de um caractere Unicode para seu equivalente em maiúsculas.Converts the value of a Unicode character to its uppercase equivalent.

ToUpper(Char, CultureInfo)

Converte o valor de um caractere Unicode especificado em seu equivalente em letras maiúsculas usando as informações de formatação específicas à cultura especificadas.Converts the value of a specified Unicode character to its uppercase equivalent using specified culture-specific formatting information.

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.The Unicode character to convert.

culture
CultureInfo

Um objeto que fornece regras de uso de maiúsculas específicas da cultura.An object that supplies culture-specific casing rules.

Retornos

O equivalente em letras maiúsculas de c, modificado de acordo com culture ou o valor inalterado de c, se c já estiver em letras maiúsculas, não tiver um equivalente em letras maiúsculas ou não for alfabético.The uppercase equivalent of c, modified according to culture, or the unchanged value of c if c is already uppercase, has no uppercase equivalent, or is not alphabetic.

Exceções

culture é null.culture is null.

Exemplos

O exemplo a seguir converte cada caractere em uma matriz para seu equivalente em maiúsculas para a cultura en-US, a cultura invariável e a cultura tr-TR.The following example converts each character in an array to its uppercase equivalent for the en-US culture, the invariant culture, and the tr-TR culture. Neste exemplo, o equivalente em maiúsculas de cada letra minúscula é idêntico a todas as culturas, exceto por um caso.In this example, the uppercase equivalent of each lowercase letter is identical for all cultures except for one case. O caractere "i" minúsculo (U + 0069) converte para "I" (U + 0049) nas culturas en-US e invariável, mas para "i" (U + 0130) na cultura tr-TR.The lowercase "i" character (U+0069) converts to "I" (U+0049) in the en-US and invariant cultures, but to "İ" (U+0130) in the tr-TR culture.

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
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 letras maiúsculas.Use String.ToUpper to convert a string to uppercase.

Veja também

ToUpper(Char)

Converte o valor de um caractere Unicode para seu equivalente em maiúsculas.Converts the value of a Unicode character to its uppercase equivalent.

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.The Unicode character to convert.

Retornos

O equivalente, em maiúsculas, de c, ou o valor inalterado de c, se c já estiver em maiúsculas, não tiver um equivalente em maiúsculas ou não for alfabético.The uppercase equivalent of c, or the unchanged value of c if c is already uppercase, has no uppercase equivalent, or is not alphabetic.

Exemplos

O exemplo a seguir converte cada caractere em uma matriz para seu equivalente em maiúsculas.The following example converts each character in an array to its uppercase equivalent.

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)
//       ? --> ?
//       ä --> Ä
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 maiúsculas e minúsculas são obtidas da cultura atual.Casing rules are obtained from the current culture.

Use String.ToUpper para converter uma cadeia de caracteres em letras maiúsculas.Use String.ToUpper to convert a string to uppercase.

Notas aos Chamadores

Conforme explicado nas práticas recomendadas para usar cadeias decaracteres, recomendamos que você evite chamar métodos de maiúsculas e minúsculas de caracteres que substituem valores padrão.As explained in Best Practices for Using Strings, we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Em vez disso, você deve chamar métodos que exigem que parâmetros sejam especificados explicitamente.Instead, you should call methods that require parameters to be explicitly specified. Para converter um caractere em maiúsculas usando as convenções de maiúsculas e minúsculas da cultura atual, chame a sobrecarga do método ToUpper(Char, CultureInfo) com um valor de CurrentCulture para seu parâmetro culture.To convert a character to uppercase by using the casing conventions of the current culture, call the ToUpper(Char, CultureInfo) method overload with a value of CurrentCulture for its culture parameter.

Veja também

Aplica-se a