Char.ToUpper Char.ToUpper Char.ToUpper Char.ToUpper Method

Определение

Преобразует значение символа Юникода в эквивалентный символ верхнего регистра.Converts the value of a Unicode character to its uppercase equivalent.

Перегрузки

ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo)

Преобразует значение указанного символа Юникода в его эквивалент в верхнем регистре, используя указанные сведения о форматировании, связанные с языком и региональными параметрами.Converts the value of a specified Unicode character to its uppercase equivalent using specified culture-specific formatting information.

ToUpper(Char) ToUpper(Char) ToUpper(Char) ToUpper(Char)

Преобразует значение символа Юникода в эквивалентный символ верхнего регистра.Converts the value of a Unicode character to its uppercase equivalent.

ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo) ToUpper(Char, CultureInfo)

Преобразует значение указанного символа Юникода в его эквивалент в верхнем регистре, используя указанные сведения о форматировании, связанные с языком и региональными параметрами.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

Параметры

c
Char Char Char Char

Знак Юникода, который необходимо преобразовать.The Unicode character to convert.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

Объект, задающий правила определения регистра для языка и региональных параметров.An object that supplies culture-specific casing rules.

Возвраты

Эквивалент c в верхнем регистре, измененный согласно culture, или значение c без изменений, если c уже является буквой верхнего регистра, не имеет эквивалента в верхнем регистре или не является буквой алфавита.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.

Исключения

Свойство culture имеет значение null.culture is null.

Примеры

В следующем примере каждый символ в массиве преобразуется в его эквивалент в верхнем регистре для языка и региональных параметров en-US, инвариантный язык и региональные параметры 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. В этом примере прописные буквы в верхнем регистре одинаковы для всех языков и региональных параметров, за исключением одного варианта.In this example, the uppercase equivalent of each lowercase letter is identical for all cultures except for one case. Символ "i" в нижнем регистре (U + 0069) преобразуется в "I" (U + 0049) в EN-US и инвариантные языки и региональные параметры, а в "i" (U + 0130) в культуре 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    

Комментарии

Используйте String.ToUpper для преобразования строки в верхний регистр.Use String.ToUpper to convert a string to uppercase.

Дополнительно

ToUpper(Char) ToUpper(Char) ToUpper(Char) ToUpper(Char)

Преобразует значение символа Юникода в эквивалентный символ верхнего регистра.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

Параметры

c
Char Char Char Char

Знак Юникода, который необходимо преобразовать.The Unicode character to convert.

Возвраты

Эквивалент параметра c в верхнем регистре или значение c без изменений, если c уже является буквой верхнего регистра, не имеет эквивалента в верхнем регистре или не является буквой алфавита.The uppercase equivalent of c, or the unchanged value of c if c is already uppercase, has no uppercase equivalent, or is not alphabetic.

Примеры

В следующем примере каждый символ в массиве преобразуется в его эквивалент в верхнем регистре.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)
'       ж --> Ж
'       ä --> Ä

Комментарии

Правила учета регистра берутся из текущего языка и региональных параметров.Casing rules are obtained from the current culture.

Используйте String.ToUpper для преобразования строки в верхний регистр.Use String.ToUpper to convert a string to uppercase.

Примечания для тех, кто вызывает этот метод

Как описано в рекомендациях по использованию строк, рекомендуется избегать вызова методов с регистром символов и строкового регистра, которые заменяют значения по умолчанию.As explained in Best Practices for Using Strings, we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Вместо этого следует вызывать методы, для которых требуется явно указать параметры.Instead, you should call methods that require parameters to be explicitly specified. Чтобы преобразовать символ в верхний регистр с помощью соглашений о регистре текущего языка и региональных параметров, вызовите ToUpper(Char, CultureInfo) перегрузку метода со CurrentCulture значением для его 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.

Дополнительно

Применяется к