LCase Function (Visual Basic)

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

Parameters

  • Value
    Required. Any valid String or Char expression.

Remarks

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.

Example

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)

Requirements

Namespace:Microsoft.VisualBasic

**Module:**Strings

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

See Also

Reference

UCase Function (Visual Basic)

Other Resources

Strings in Visual Basic

Introduction to Strings in Visual Basic