Char.ToLower Method (Char)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Shared Function ToLower ( _
    c As Char _
) As Char
public static char ToLower(
    char c
)

Parameters

Return Value

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

Remarks

Casing rules are obtained from the current culture.

Use String.ToLower to convert a string to lowercase.

Notes to Callers

Starting in Silverlight 4, the behavior of the Char.ToLower(Char) method has changed. In Silverlight 4, it converts c to lowercase using the casing rules of the current culture. This conforms to the behavior of the Char.ToLower(Char) method in the full .NET Framework. In Silverlight 2 and Silverlight 3, Char.ToLower(Char) uses the casing rules of the invariant culture. If the common language runtime determines that a Silverlight-based application was compiled against Silverlight 2 or Silverlight 3, it performs an ordinal comparison; otherwise, it performs a culture-sensitive comparison.

Examples

The following example demonstrates ToLower.


Module Example

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      outputBlock.Text &= Char.ToLower("A"c) & vbCrLf               ' Output: "a"
   End Sub

End Module
using System;
using System.Globalization;  // for CultureInfo

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text += Char.ToLower('A') + "\n";             // Output: "a"
   }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.