Char.ToUpper Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Преобразует значение символа Юникода в его эквивалент в верхнем регистре.

Перегрузки

Имя	Описание
ToUpper(Char)	Преобразует значение символа Юникода в его эквивалент в верхнем регистре.
ToUpper(Char, CultureInfo)	Преобразует значение указанного символа Юникода в его верхний регистр, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.

ToUpper(Char)

Исходный код:

Char.cs

Преобразует значение символа Юникода в его эквивалент в верхнем регистре.

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

Эквивалент верхнего регистра или без измененийc, если c уже верхний регистр, не имеет эквивалентного верхнего регистра cили не является алфавитным.

Примеры

В следующем примере каждый символ в массиве преобразуется в эквивалент верхнего регистра.

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)
'       ж --> Ж
'       ä --> Ä

Комментарии

Правила регистра получены из текущего языка и региональных параметров.

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

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

Как описано в рекомендациях по использованию строк, рекомендуется избегать вызова методов регистра символов и строковых регистров, заменяющих значения по умолчанию. Вместо этого следует вызывать методы, требующие явного указания параметров. Чтобы преобразовать символ в верхний регистр с помощью соглашений о регистре текущего языка и региональных параметров, вызовите ToUpper(Char, CultureInfo) перегрузку метода со значением CurrentCulture для параметра culture .

См. также раздел

• System.Text.Rune.ToUpper(System.Text.Rune,System.Globalization.CultureInfo)
• System.Text.Rune.ToLower(System.Text.Rune,System.Globalization.CultureInfo)
• System.String.ToUpper
• System.Char.ToLower(System.Char,System.Globalization.CultureInfo)

ToUpper(Char, CultureInfo)

Исходный код:

Char.cs

Преобразует значение указанного символа Юникода в его верхний регистр, используя указанные сведения о форматировании, зависящие от языка и региональных параметров.

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

Символ Юникода для преобразования.

culture

CultureInfo

Объект, предоставляющий правила регистра, зависящие от языка и региональных параметров.

Возвращаемое значение

Char

Эквивалент верхнего регистра c, измененный в соответствии с cultureили без изменений c , если c уже верхний регистр, не имеет эквивалентного верхнего регистра или не является алфавитным.

Исключения

ArgumentNullException

culture равно null.

Примеры

В следующем примере каждый символ в массиве преобразуется в его верхний регистр для языка и региональных параметров en-US, инвариантного языка и языка и региональных параметров tr-TR. В этом примере эквивалент верхнего регистра каждой строчной буквы идентичен для всех языков и региональных параметров, за исключением одного случая. Нижний регистр "i" (U+0069) преобразуется в "I" (U+0049) в en-US и инвариантных региональных параметров, но в "İ" (U+0130) в 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

Комментарии

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

См. также раздел

• CurrentCulture
• System.Text.Rune.ToUpper(System.Text.Rune,System.Globalization.CultureInfo)
• System.Text.Rune.ToLower(System.Text.Rune,System.Globalization.CultureInfo)
• System.String.ToUpper
• System.Char.ToLower(System.Char,System.Globalization.CultureInfo)