Char.ToUpper Method (Char, CultureInfo)

Converts the value of a specified Unicode character to its uppercase equivalent using specified culture-specific formatting information.

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

public static char ToUpper(
	char c,
	CultureInfo culture
)

Parameters

c
Type: System.Char

The Unicode character to convert.

culture
Type: System.Globalization.CultureInfo

An object that supplies culture-specific casing rules.

Return Value

Type: System.Char
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.

ExceptionCondition
ArgumentNullException

culture is null.

Use String.ToUpper to convert a string to uppercase.

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. 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

.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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft