You are currently offline, waiting for your internet to reconnect

How to convert string to lowercase, uppercase, or title (proper) case by using Visual Basic .NET or Visual Basic 2005

This article was previously published under Q312897
SUMMARY
This article demonstrates how to convert a string to uppercase, lowercase, or title (or proper) case.

Visual Basic .NET or Visual Basic 2005 offers several ways to convert strings. If you use the Microsoft .NET Framework classes, you can use methods of the String and TextInfo classes. Visual Basic .NET or Visual Basic 2005 also includes the built-in UCase, LCase, and StrConv functions that serve the same purpose.

Although you can use the String class to convert a string to uppercase or lowercase, you must use a method in the System.Globalization.TextInfo class to convert a string to title case.

back to the top

Convert String Using the String Class or Visual Basic Functions

This section describes how to use the methods of the String class and the Visual Basic built-in functions (UCase, LCase and StrConv) to convert a string to uppercase, lowercase, and title case.

back to the top

Convert a String to Uppercase

The String class has a static method named ToUpper. You can use this method to convert a string to uppercase. You can also use the UCase or StrConv function. For example:
    Dim upper as String = "converted from lowercase"    Console.WriteLine(upper.ToUpper())    Console.WriteLine(UCase(upper))    Console.WriteLine(StrConv(upper,VbStrConv.UpperCase))				
back to the top

Convert a String to Lowercase

The ToLower method is the complement of the ToUpper method. ToLower converts a string to lowercase. You can also use the LCase or StrConv function. For example:
    Dim lower as String = "CONVERTED FROM UPPERCASE"    Console.WriteLine(lower.ToLower())    Console.WriteLine(LCase(lower))    Console.WriteLine(StrConv(lower,VbStrConv.LowerCase))				
back to the top

Convert a String to Title Case

To convert a string to title (or proper) case, pass the string to the StrConv function with a constant that identifies the operation to be performed. For example:
    Dim title as String = "converted to title case"    Console.WriteLine(StrConv(title, VbStrConv.ProperCase))				
back to the top

Convert String Using the TextInfo Class

This section describes how to use the TextInfo class to convert strings. Because you can use the conversion methods in TextInfo to control culture information, you may want to use this class when you need to specify particular culture settings.

TextInfo is member of the System.Globalization namespace. TextInfo provides the ToUpper, ToLower, and ToTitleCase methods for conversion to uppercase, lowercase, and title case respectively. Unlike the methods of the String class, the TextInfo methods are not static methods and require an instance of the class.

In most situations, you can default to the culture that is currently in use. Culture information is a property of the thread on which the code is running. To obtain the culture information, you must gain access to the current thread and retrieve the CurrentCulture property from that thread. Once you accomplish this, you can create the TextInfo object. For example:
    Dim curCulture As CultureInfo = Thread.CurrentThread.CurrentCulture    Dim tInfo As TextInfo = curCulture.TextInfo()				
The following code sample illustrates how to call the three string conversion methods of the TextInfo class:
    Dim title as String = "converted using textinfo"    Console.WriteLine(tInfo.ToTitleCase(title))    Console.WriteLine(tInfo.ToLower(title))    Console.WriteLine(tInfo.ToUpper(title))				
If you need to create or manipulate strings that have specific culture settings, you can use one of the overloaded constructors of the TextInfo class to create strings with any of the available culture options.

back to the top

Step-by-Step Example

  1. Open a new Console Application project in Visual Basic .NET or in Visual Basic 2005.
  2. Replace the code in Module1.vb with the following code:
    Imports System.GlobalizationImports System.ThreadingModule Module1    Public Sub main()        Dim title As String = "this is my converted string"        Console.WriteLine("Built-in Methods")        Console.WriteLine("----------------")        Console.WriteLine(UCase(title))        Console.WriteLine(LCase(title))        Console.WriteLine(StrConv(title, VbStrConv.UpperCase))        Console.WriteLine(StrConv(title, VbStrConv.LowerCase))        Console.WriteLine(StrConv(title, VbStrConv.ProperCase))        Console.WriteLine()        Console.WriteLine("String Class")        Console.WriteLine("------------")        Console.WriteLine(title.ToUpper())        Console.WriteLine(title.ToLower())        Console.WriteLine()        Console.WriteLine("TextInfo Class")        Console.WriteLine("--------------")        'Get culture information from current thread.        Dim curCulture As CultureInfo = Thread.CurrentThread.CurrentCulture        'Create TextInfo object.        Dim tInfo As TextInfo = curCulture.TextInfo()        'Convert to uppercase.        Console.WriteLine(tInfo.ToUpper(title))        'Convert to lowercase.        Console.WriteLine(tInfo.ToLower(title))        'Convert to title case.        Console.WriteLine(tInfo.ToTitleCase(title))    End SubEnd Module					
  3. Press the CTRL+F5 key combination to build and run the project.
  4. Observe the results in the Console window.
back to the top

Note on the InvariantCulture Property

When you use the Globalization namespace to convert data, if you store the converted data instead of displaying it for the user, you can use the InvariantCulture property of CultureInfo class.

InvariantCulture is neither a neutral nor a specific culture; it is a culture that is culture-insensitive. If you use InvariantCulture when you store data, the data is stored in a consistent manner, regardless of any specific user or cultural system settings that may be in effect. For more information, refer to the References section.

The preceding code sample uses the CultureInfo properties of the current thread:
Dim curCulture As CultureInfo = Thread.CurrentThread.CurrentCulture				
To use InvariantCulture in the same scenario, use the following code:
Dim curCulture As CultureInfo = CultureInfo.InvariantCulture				
back to the top
REFERENCES
For additional information, refer to the following topics in the Microsoft Visual Studio .NET or Visual Studio 2005 Online Help documentation:
  • Using the InvariantCulture Property
  • TextInfo Class
  • CultureInfo Class
  • String Class
back to the top
upper case lower
Properties

Article ID: 312897 - Last Review: 12/06/2006 23:18:59 - Revision: 3.3

Microsoft Visual Basic 2005, Microsoft Visual Basic .NET 2003 Standard Edition, Microsoft Visual Basic .NET 2002 Standard Edition

  • kbvs2005swept kbvs2005applies kbhowtomaster KB312897
Feedback