戻り値

例外

例

次の例では、大文字の2つの文字列を、英語 (米国) とトルコ語 (トルコ) のカルチャを使用して小文字に変換し、その後、小文字の文字列を比較します。The following example converts two strings of uppercase characters to lowercase characters using the English-United States and Turkish-Turkey cultures, then compares the lowercase strings.大文字の文字列は同じですが、1つの文字列に Unicode ラテン大文字 I が出現するたびに、もう一方の文字列には上記のドット付きのラテン大文字 I が含まれている点が異なります。The uppercase strings are identical except that for each occurrence of the Unicode LATIN CAPITAL LETTER I in one string, the other string contains LATIN CAPITAL LETTER I WITH DOT ABOVE.

注釈

culture パラメーターによって指定されたカルチャの大文字と小文字の規則によって、文字列の大文字と小文字の変更方法が決まります。The casing rules of the culture specified by the culture parameter determine the way the case of the string is changed.

注意

このメソッドは、現在のインスタンスの値を変更しません。This method does not modify the value of the current instance.代わりに、現在のインスタンス内のすべての文字が小文字に変換される新しい文字列が返されます。Instead, it returns a new string in which all characters in the current instance are converted to lowercase.

Public Class ToLowerTest
Public Shared Sub Main()
Dim info As String() = {"Name", "Title", "Age", "Location", "Gender"}
Console.WriteLine("The initial values in the array are:")
Dim s As String
For Each s In info
Console.WriteLine(s)
Next
Console.WriteLine("{0}The lowercase of these values is:", Environment.NewLine)
For Each s In info
Console.WriteLine(s.ToLower())
Next
Console.WriteLine("{0}The uppercase of these values is:", Environment.NewLine)
For Each s In info
Console.WriteLine(s.ToUpper())
Next
End Sub
End Class
' 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

注釈

このメソッドは、現在のカルチャの大文字と小文字の規則を考慮します。This method takes into account the casing rules of the current culture.

注意

このメソッドは、現在のインスタンスの値を変更しません。This method does not modify the value of the current instance.代わりに、現在のインスタンス内のすべての文字が小文字に変換される新しい文字列が返されます。Instead, it returns a new string in which all characters in the current instance are converted to lowercase.

セキュリティの考慮事項Security Considerations

ToLower() メソッドを呼び出すことによって生成される大文字と小文字の演算では、現在のカルチャの大文字と小文字の表記規則が考慮されます。The casing operation that results from calling the ToLower() method takes the casing conventions of the current culture into account.ファイル名、名前付きパイプ、レジストリキーなど、オペレーティングシステム識別子の小文字または大文字のバージョンが必要な場合は、ToLowerInvariant または ToUpperInvariant メソッドを使用します。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.これにより、(ToLower() メソッドとは異なり) すべてのカルチャで同じ結果が生成され、より効率的に実行されます。This produces the same result in every culture (unlike the ToLower() method) and performs more efficiently.

注意 (呼び出し元)

「文字列を使用するためのベストプラクティス」で説明されているように、既定値を置き換える文字列の大文字と小文字の使い分けメソッドを呼び出さずに、パラメーターを明示的に指定する必要があるメソッドを呼び出すことをお勧めします。As explained in Best Practices for Using Strings, we recommend that you avoid calling string casing methods that substitute default values and instead call methods that require parameters to be explicitly specified.現在のカルチャの大文字と小文字の表記規則を使用して文字を小文字に変換するには、その culture パラメーターに CurrentCulture 値を指定して、ToLower(CultureInfo) メソッドのオーバーロードを呼び出します。To convert a character to lowercase by using the casing conventions of the current culture, call the ToLower(CultureInfo) method overload with a value of CurrentCulture for its culture parameter.