Freigeben über


Char.ToUpper Methode

Definition

Konvertiert den Wert eines Unicode-Zeichens in den entsprechenden Großbuchstaben.

Überlädt

ToUpper(Char, CultureInfo)

Konvertiert den Wert eines angegebenen Unicode-Zeichens unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen in den entsprechenden Großbuchstaben.

ToUpper(Char)

Konvertiert den Wert eines Unicode-Zeichens in den entsprechenden Großbuchstaben.

ToUpper(Char, CultureInfo)

Konvertiert den Wert eines angegebenen Unicode-Zeichens unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen in den entsprechenden Großbuchstaben.

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

Parameter

c
Char

Das zu konvertierende Unicode-Zeichen.

culture
CultureInfo

Ein Objekt, das kulturspezifische Regeln zur Groß- und Kleinschreibung bereitstellt.

Gibt zurück

Char

Die gemäß c veränderte Entsprechung von culture in Großbuchstaben oder der unveränderte Wert von c, wenn c bereits aus Großbuchstaben besteht, keine Entsprechung in Großbuchstaben besitzt oder kein alphabetischer Wert ist.

Ausnahmen

culture ist null.

Beispiele

Im folgenden Beispiel wird jedes Zeichen in einem Array in die großgeschriebene Entsprechung für die Kultur "en-US", die invariante Kultur und die Tr-TR-Kultur konvertiert. In diesem Beispiel ist die Großbuchstabe jedes Kleinbuchstabens für alle Kulturen mit Ausnahme eines Großbuchstabens identisch. Das Kleinbuchstabe "i" (U+0069) wird in den Kulturen "en-US" und "invarianten" in "I" (U+0049) konvertiert, in der Tr-TR-Kultur jedoch in "μ" (U+0130).

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

Hinweise

Verwenden Sie String.ToUpper , um eine Zeichenfolge in Großbuchstaben zu konvertieren.

Siehe auch

Gilt für

ToUpper(Char)

Konvertiert den Wert eines Unicode-Zeichens in den entsprechenden Großbuchstaben.

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

Parameter

c
Char

Das zu konvertierende Unicode-Zeichen.

Gibt zurück

Char

Die Entsprechung von c in Großbuchstaben oder der unveränderte Wert von c, wenn c bereits aus Großbuchstaben besteht, keine Entsprechung in Großbuchstaben hat oder kein alphabetischer Wert ist.

Beispiele

Im folgenden Beispiel wird jedes Zeichen in einem Array in die Entsprechende in Großbuchstaben konvertiert.

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

Hinweise

Groß-/Kleinschreibungsregeln werden aus der aktuellen Kultur abgerufen.

Verwenden Sie String.ToUpper , um eine Zeichenfolge in Großbuchstaben zu konvertieren.

Hinweise für Aufrufer

Wie unter Best Practices for Using Strings (Bewährte Methoden für die Verwendung von Zeichenfolgen)erläutert, empfiehlt es sich, das Aufrufen von Methoden zur Groß- und Kleinschreibung von Zeichen und Zeichenfolgen zu vermeiden, die Standardwerte ersetzen. Stattdessen sollten Sie Methoden aufrufen, die erfordern, dass Parameter explizit angegeben werden. Um ein Zeichen mithilfe der Groß-/Kleinschreibungskonventionen der aktuellen Kultur in Großbuchstaben zu konvertieren, rufen Sie die ToUpper(Char, CultureInfo) Methodenüberladung mit dem Wert CurrentCulture für ihren Parameter culture auf.

Siehe auch

Gilt für