This documentation is archived and is not being maintained.

LCase Function (Visual Basic)

Visual Studio 2008

Returns a string or character converted to lowercase.

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


Required. Any valid String or Char expression.

Only uppercase letters are converted to lowercase; all lowercase 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 LCase function to return a lowercase version of a string.

' String to convert. 
Dim UpperCase As String = "Hello World 1234" 
' Returns "hello world 1234". 
Dim LowerCase As String = LCase(UpperCase)

Namespace: Microsoft.VisualBasic

Module: Strings

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