Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String.ToUpper Method

Returns a copy of this String in uppercase.

Overload List

Returns a copy of this String in uppercase, using the casing rules of the current culture.

Supported by the .NET Compact Framework.

[Visual Basic] Overloads Public Function ToUpper() As String
[C#] public string ToUpper();
[C++] public: String* ToUpper();
[JScript] public function ToUpper() : String;

Returns a copy of this String in uppercase, using the casing rules of the specified culture.

Supported by the .NET Compact Framework.

[Visual Basic] Overloads Public Function ToUpper(CultureInfo) As String
[C#] public string ToUpper(CultureInfo);
[C++] public: String* ToUpper(CultureInfo*);
[JScript] public function ToUpper(CultureInfo) : String;

Example

[Visual Basic, C#, C++] Note   This example shows how to use one of the overloaded versions of ToUpper. For other examples that might be available, see the individual overload topics.
[Visual Basic] 
' Sample for String.ToUpper(CultureInfo)
Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic

Class Sample
   
   Public Shared Sub Main()
      Dim str1 As [String] = "indigo"
      Dim str2, str3 As [String]
      
      Console.WriteLine()
      Console.WriteLine("str1 = '{0}'", str1)

      Console.WriteLine("str2 = Upper case copy of str1 using English-United States culture.")
      ' str2 is an upper case copy of str1, using English-United States culture.
      str2 = str1.ToUpper(New CultureInfo("en-US", False))
      
      ' str3 is an upper case copy of str1, using Turkish-Turkey culture.
      Console.WriteLine("str3 = Upper case copy of str1 using Turkish-Turkey culture.")
      str3 = str1.ToUpper(New CultureInfo("tr-TR", False))
      
      ' Compare the code points in str2 and str3.
      Console.WriteLine()
      Console.WriteLine("str2 is {0} to str3.", IIf(0 = [String].CompareOrdinal(str2, str3), "equal", "not equal"))
      CodePoints("str1", str1)
      CodePoints("str2", str2)
      CodePoints("str3", str3)
   End Sub 'Main
   
   Public Shared Sub CodePoints(title As [String], s As [String])
      Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title)
      Dim c As Char
      For Each c In  s
         Console.Write("{0:x4} ", AscW(c))
      Next c
      Console.WriteLine()
   End Sub 'CodePoints
End Class 'Sample
'
'This example produces the following results:
'
'str1 = 'indigo'
'str2 = Upper case copy of str1 using English-United States culture.
'str3 = Upper case copy of str1 using Turkish-Turkey culture.
'
'str2 is not equal to str3.
'
'The code points in str1 are:
'0069 006e 0064 0069 0067 006f
'
'The code points in str2 are:
'0049 004e 0044 0049 0047 004f
'
'The code points in str3 are:
'0130 004e 0044 0130 0047 004f
'

[C#] 
// Sample for String.ToUpper(CultureInfo)
using System;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    String str1 = "indigo";
    String str2, str3;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}'", str1);

    Console.WriteLine("str2 = Upper case copy of str1 using English-United States culture.");
    // str2 is an upper case copy of str1, using English-United States culture.
    str2 = str1.ToUpper(new CultureInfo("en-US", false));

    // str3 is an upper case copy of str1, using Turkish-Turkey culture.
    Console.WriteLine("str3 = Upper case copy of str1 using Turkish-Turkey culture.");
    str3 = str1.ToUpper(new CultureInfo("tr-TR", false));

    // Compare the code points in str2 and str3.
    Console.WriteLine();
    Console.WriteLine("str2 is {0} to str3.", 
         ((0 == String.CompareOrdinal(str2, str3)) ? "equal" : "not equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);
    CodePoints("str3", str3);
    }

    public static void CodePoints(String title, String s)
    {
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title);
    foreach (ushort u in s)
      Console.Write("{0:x4} ", u);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United States culture.
str3 = Upper case copy of str1 using Turkish-Turkey culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

[C++] 
// Sample for String::ToUpper(CultureInfo)
#using <mscorlib.dll>

using namespace System;
using namespace System::Globalization;

void CodePoints(String* title, String* s) {
   Console::Write(S" {0}The code points in {1} are: {0}", Environment::NewLine, title);
   System::Collections::IEnumerator* myEnum = s->GetEnumerator();
   while (myEnum->MoveNext()) {
      UInt16 u = *__try_cast<Char*>(myEnum->Current);
      Console::Write(S"{0:x4} ", __box( u));
   }
   Console::WriteLine();
}

int main() {
   String*  str1 = S"indigo";
   String* str2, *str3;

   Console::WriteLine();
   Console::WriteLine(S"str1 = ' {0}'", str1);

   Console::WriteLine(S"str2 = Upper case copy of str1 using English-United States culture.");
   // str2 is an upper case copy of str1, using English-United States culture.
   str2 = str1->ToUpper(new CultureInfo(S"en-US", false));

   // str3 is an upper case copy of str1, using Turkish-Turkey culture.
   Console::WriteLine(S"str3 = Upper case copy of str1 using Turkish-Turkey culture.");
   str3 = str1->ToUpper(new CultureInfo(S"tr-TR", false));

   // Compare the code points in str2 and str3.
   Console::WriteLine();
   Console::WriteLine(S"str2 is {0} to str3.",
      ((0 == String::CompareOrdinal(str2, str3)) ? S"equal" : S"not equal"));
   CodePoints(S"str1", str1);
   CodePoints(S"str2", str2);
   CodePoints(S"str3", str3);
}


/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United States culture.
str3 = Upper case copy of str1 using Turkish-Turkey culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

See Also

String Class | String Members | System Namespace

Show:
© 2015 Microsoft