String.ToLower メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

この文字列のコピーを小文字に変換して返します。

オーバーロード

ToLower()	この文字列のコピーを小文字に変換して返します。
ToLower(CultureInfo)	指定されたカルチャの大文字と小文字の規則を使用して、この文字列のコピーを小文字に変換して返します。

ToLower()

ソース:

String.Manipulation.cs

この文字列のコピーを小文字に変換して返します。

C#

public string ToLower();

戻り値

String

小文字の文字列。

例

次の例では、複数の大文字と小文字が混在する文字列を小文字に変換します。

C#

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());
    }
}
// The example displays the following output:
//       The initial values in the array are:
//       Name
//       Title
//       Age
//       Location
//       Gender
//
//       The lowercase of these values is:
//       name
//       title
//       age
//       location
//       gender
//
//       The uppercase of these values is:
//       NAME
//       TITLE
//       AGE
//       LOCATION
//       GENDER

注釈

このメソッドでは、現在のカルチャの大文字と小文字の規則が考慮されます。

注意

このメソッドは、現在のインスタンスの値を変更しません。 代わりに、現在のインスタンス内のすべての文字が小文字に変換される新しい文字列を返します。

メソッドの呼び出しによって発生する大文字と小文字の ToLower() 操作では、現在のカルチャの大文字と小文字の規則が考慮されます。 ファイル名、名前付きパイプ、レジストリ キーなど、オペレーティング システム識別子の小文字または大文字のバージョンが必要な場合は、 メソッドまたは ToUpperInvariant メソッドをToLowerInvariant使用します。 これにより、(メソッドとは異なり) すべてのカルチャで同じ結果が ToLower() 生成され、より効率的に実行されます。

注意 (呼び出し元)

「文字列を使用するためのベスト プラクティス」で説明されているように、既定値に代わる文字列大文字と小文字のメソッドを呼び出さないようにし、代わりにパラメーターを明示的に指定する必要があるメソッドを呼び出さないようにすることをお勧めします。 現在のカルチャの大文字と小文字の規則を使用して文字を小文字に変換するには、そのパラメーターの 値CurrentCulturecultureを 使用してメソッド オーバーロードをToLower(CultureInfo)呼び出すことによって、意図を明示的に通知します。 言語対応の比較が必要ない場合は、 の使用を Ordinal検討してください。

こちらもご覧ください

• ToLowerInvariant()
• ToUpper()
• ToUpperInvariant()

ToLower(CultureInfo)

ソース:

String.Manipulation.cs

指定されたカルチャの大文字と小文字の規則を使用して、この文字列のコピーを小文字に変換して返します。

C#

public string ToLower(System.Globalization.CultureInfo? culture);

パラメーター

culture

CultureInfo

カルチャ固有の大文字と小文字の規則を提供するオブジェクト。 culture が null の場合は、現在のカルチャが使用されます。

戻り値

String

現在の文字列を小文字にしたもの。

例

次の例では、English-United States カルチャと Turkish-Turkey カルチャを使用して、大文字の 2 つの文字列を小文字に変換し、小文字の文字列を比較します。 大文字の文字列は同じですが、一方の文字列で Unicode LATIN CAPITAL LETTER I が出現するたびに、もう一方の文字列にはラテン大文字 I と DOT ABOVE が含まれています。

C#

// Sample for String.ToLower(CultureInfo)

using System;
using System.Globalization;

class Sample
{
    public static void Main()
    {
    String str1 = "INDIGO";
    // str2 = str1, except each 'I' is '\u0130' (Unicode LATIN CAPITAL I WITH DOT ABOVE).
    String str2 = new String(new Char[] {'\u0130', 'N', 'D', '\u0130', 'G', 'O'});
    String str3, str4;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}'", str1);

    Console.WriteLine();
    Console.WriteLine("str1 is {0} to str2.",
         ((0 == String.CompareOrdinal(str1, str2)) ? "equal" : "not equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);

    Console.WriteLine();
    // str3 is a lower case copy of str2, using English-United States culture.
    Console.WriteLine("str3 = Lower case copy of str2 using English-United States culture.");
    str3 = str2.ToLower(new CultureInfo("en-US", false));

    // str4 is a lower case copy of str2, using Turkish-Turkey culture.
    Console.WriteLine("str4 = Lower case copy of str2 using Turkish-Turkey culture.");
    str4 = str2.ToLower(new CultureInfo("tr-TR", false));

    // Compare the code points in str3 and str4.
    Console.WriteLine();
    Console.WriteLine("str3 is {0} to str4.",
         ((0 == String.CompareOrdinal(str3, str4)) ? "equal" : "not equal"));
    CodePoints("str3", str3);
    CodePoints("str4", str4);
    }

    public static void CodePoints(String title, String s)
    {
    Console.Write("{0}The code points in {1} are: {0}", Environment.NewLine, title);
    foreach (ushort u in s)
      Console.Write("{0:x4} ", u);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

str1 = 'INDIGO'

str1 is not equal to str2.

The code points in str1 are:
0049 004e 0044 0049 0047 004f

The code points in str2 are:
0130 004e 0044 0130 0047 004f

str3 = Lower case copy of str2 using English-United States culture.
str4 = Lower case copy of str2 using Turkish-Turkey culture.

str3 is equal to str4.

The code points in str3 are:
0069 006e 0064 0069 0067 006f

The code points in str4 are:
0069 006e 0064 0069 0067 006f
*/

注釈

パラメーターで指定されたカルチャの大文字と小文字の規則によって、 culture 文字列の大文字と小文字が変更される方法が決まります。

注意

このメソッドは、現在のインスタンスの値を変更しません。 代わりに、現在のインスタンス内のすべての文字が小文字に変換される新しい文字列を返します。

メソッドに 以外の ToLower(CultureInfo) オブジェクトを CultureInfo 渡すと、大文字と小文字の操作によってカルチャ固有の規則が考慮 CultureInfo.InvariantCultureされます。 ファイル名、名前付きパイプ、レジストリ キーなど、オペレーティング システム識別子の小文字または大文字のバージョンが必要な場合は、 メソッドまたは ToUpperInvariant メソッドをToLowerInvariant使用します。 これにより、すべてのカルチャで同じ結果が生成され、より効率的に実行されます。

こちらもご覧ください

• CultureInfo
• ToUpper()