This documentation is archived and is not being maintained.

UCase Function (Visual Basic)

Visual Studio 2008

Returns a string or character containing the specified string converted to uppercase.

Public Shared Function UCase(ByVal Value As Char) As Char
' -or-
Public Shared Function UCase(ByVal Value As String) As String


Required. Any valid String or Char expression.

Only lowercase letters are converted to uppercase; all uppercase letters and nonletter characters remain unchanged.

This function uses the application's culture information when manipulating the string so that the case changes are appropriate for the locale in which the application is being used.

Security noteSecurity Note:

If your application makes security decisions based on the result of a comparison or case-change operation, then the operation should use the String.Compare method, and pass Ordinal or OrdinalIgnoreCase for the comparisonType argument. For more information, see How Culture Affects Strings in Visual Basic.

This example uses the UCase function to return an uppercase version of a string.

' String to convert. 
Dim LowerCase As String = "Hello World 1234" 
' Returns "HELLO WORLD 1234". 
Dim UpperCase As String = UCase(LowerCase)

Namespace: Microsoft.VisualBasic

Module: Strings

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)