Strings.LCase Method

Definition

Returns a string or character converted to lowercase.

Overloads

LCase(Char)

Returns a string or character converted to lowercase.

LCase(String)

Returns a string or character converted to lowercase.

LCase(Char)

Returns a string or character converted to lowercase.

public:
 static char LCase(char Value);
public static char LCase (char Value);
static member LCase : char -> char
Public Function LCase (Value As Char) As Char

Parameters

Value
Char

Required. Any valid String or Char expression.

Returns

A string or character converted to lowercase.

Examples

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)

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.

Important

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.

See also

LCase(String)

Returns a string or character converted to lowercase.

public:
 static System::String ^ LCase(System::String ^ Value);
public static string LCase (string Value);
static member LCase : string -> string
Public Function LCase (Value As String) As String

Parameters

Value
String

Required. Any valid String or Char expression.

Returns

A string or character converted to lowercase.

Examples

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)

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.

Important

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.

See also

Applies to