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 Note |
---|
If your application makes security decisions based on the result of a comparison or case-change operation, then the operation should use the System.String.Compare(System.String,System.String,System.StringComparison) 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
Other Resources
Strings in Visual Basic
Introduction to Strings in Visual Basic