This documentation is archived and is not being maintained.

String.ToLower Method ()

Returns a copy of this String converted to lowercase, using the casing rules of the current culture.

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

public string ToLower ()
public String ToLower ()
public function ToLower () : String

Return Value

A String in lowercase.

This method takes into account the current culture. For more information, see the CultureInfo topic.

Security Considerations

If you need the lowercase or uppercase version of an operating system identifier, such as a file name, named pipe, or registry key, use the ToLowerInvariant or ToUpperInvariant methods.

The following code example converts several mixed case strings to lowercase.

using System;

public class ToLowerTest {
    public static void Main() {

        string [] info = {"Name", "Title", "Age", "Location", "Gender"};

        Console.WriteLine("The initial values in the array are:");
        foreach (string s in info)
            Console.WriteLine(s);

        Console.WriteLine("{0}The lowercase of these values is:", Environment.NewLine);        

        foreach (string s in info)
            Console.WriteLine(s.ToLower());

        Console.WriteLine("{0}The uppercase of these values is:", Environment.NewLine);        

        foreach (string s in info)
            Console.WriteLine(s.ToUpper());
    }
}

import System.*;

public class ToLowerTest
{
    public static void main(String[] args)
    {
        String info[] =  { "Name", "Title", "Age", "Location", "Gender" };

        Console.WriteLine("The initial values in the array are:");
        for (int iCtr = 0; iCtr < info.get_Length(); iCtr++) {
            String s = (String)info.get_Item(iCtr);
            Console.WriteLine(s);
        }

        Console.WriteLine("{0}The lowercase of these values is:", 
            Environment.get_NewLine());
        for (int iCtr = 0; iCtr < info.get_Length(); iCtr++) {
            String s = (String)info.get_Item(iCtr);
            Console.WriteLine(s.ToLower());
        }

        Console.WriteLine("{0}The uppercase of these values is:", 
            Environment.get_NewLine());
        for (int iCtr = 0; iCtr < info.get_Length(); iCtr++) {
            String s = (String)info.get_Item(iCtr);
            Console.WriteLine(s.ToUpper());
        }
    } //main
} //ToLowerTest

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Show: