Char.ToLower Method (Char, CultureInfo) (System)

Switch View :

ScriptFree

.NET Framework Class Library

Char.ToLower Method (Char, CultureInfo)

Converts the value of a specified Unicode character to its lowercase equivalent using specified culture-specific formatting information.

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

Syntax

Visual Basic

Public Shared Function ToLower ( _
	c As Char, _
	culture As CultureInfo _
) As Char

public static char ToLower(
	char c,
	CultureInfo culture
)

Visual C++

public:
static wchar_t ToLower(
	wchar_t c, 
	CultureInfo^ culture
)

static member ToLower : 
        c:char * 
        culture:CultureInfo -> char

Parameters

c: Type: System.Char
The Unicode character to convert.

culture: Type: System.Globalization.CultureInfo
An object that supplies culture-specific casing rules.

Return Value

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

Exceptions

Exception	Condition
ArgumentNullException	culture is null.

Remarks

Use String.ToLower to convert a string to lowercase.

Examples

The following code example demonstrates ToLower.

Visual Basic


imports System

Module ToLowerSample

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

End Module


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

public class ToLowerSample {
	public static void Main() {
		Console.WriteLine(Char.ToLower('A'));				// Output: "a"
	}
}

Visual C++


using namespace System;
using namespace System::Globalization;

// for CultureInfo
void main()
{
   Console::WriteLine( Char::ToLower( 'A' ) ); // Output: "a"
}

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Char Structure

ToLower Overload

System Namespace

CultureInfo.CurrentCulture

String.ToLower

Char.ToUpper