Char.ToLower Method (Char)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Converts the value of a Unicode character to its lowercase equivalent.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

Public Shared Function ToLower (
	c As Char
) As Char

Parameters

c
Type: System.Char

The Unicode character to convert.

Return Value

Type: System.Char

The lowercase equivalent of c, or the unchanged value of c, if c is already lowercase or not alphabetic.

Casing rules are obtained from the current culture.

Use String.ToLower to convert a string to lowercase.

Notes to Callers:

As explained in Best Practices for Using Strings in the .NET Framework, we recommend that you avoid calling character-casing and string-casing methods that substitute default values. Instead, you should call methods that require parameters to be explicitly specified. To convert a character to lowercase by using the casing conventions of the current culture, call the ToLower(Char, CultureInfo) method overload with a value of CultureInfo.CurrentCulture for its culture parameter.

The following example demonstrates ToLower.

imports System

Module ToLowerSample

    Sub Main()
        Console.WriteLine(Char.ToLower("A"c))               ' Output: "a"
    End Sub

End Module

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: