Export (0) Print
Expand All

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:
© 2014 Microsoft