Export (0) Print
Expand All

Char.ToUpper Method (Char)

Converts the value of a Unicode character to its uppercase equivalent.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Public Shared Function ToUpper ( _
	c As Char _
) As Char


Type: System.Char

The Unicode character to convert.

Return Value

Type: System.Char
The uppercase equivalent of c, or the unchanged value of c if c is already uppercase, has no uppercase equivalent, or is not alphabetic.

Casing rules are obtained from the current culture.

Use String.ToUpper to convert a string to uppercase.

Notes to Callers

As explained in Best Practices for Using Strings in the .NET Framework, 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. 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 CultureInfo.CurrentCulture for its culture parameter.

The following example converts each character in an array to its uppercase equivalent.

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)", ""))
   End Sub 
End Module 
' The example displays the following output: 
'       e --> E 
'       E --> E (Same Character) 
'       6 --> 6 (Same Character) 
'       , --> , (Same Character) 
'       ж --> Ж 
'       ä --> Ä

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
© 2015 Microsoft