TextInfo.ToLower メソッド

定義

指定した文字または文字列を小文字に変換します。Converts the specified character or string to lowercase.

オーバーロード

ToLower(Char)

指定した文字を小文字に変換します。Converts the specified character to lowercase.

ToLower(String)

指定した文字列を小文字に変換します。Converts the specified string to lowercase.

ToLower(Char)

指定した文字を小文字に変換します。Converts the specified character to lowercase.

public:
 virtual char ToLower(char c);
public virtual char ToLower (char c);
abstract member ToLower : char -> char
override this.ToLower : char -> char
Public Overridable Function ToLower (c As Char) As Char

パラメーター

c
Char

小文字に変換する文字。The character to convert to lowercase.

戻り値

小文字に変換するために指定する文字。The specified character converted to lowercase.

次のコード例では、英語 (米国) カルチャに基づいた文字列の大文字と小文字の区別を、カルチャ名 en-us で変更します。The following code example changes the casing of a string based on the English (United States) culture, with the culture name en-US.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the String* with mixed casing.
   String^ myString = "wAr aNd pEaCe";
   
   // Creates a TextInfo based on the S"en-US" culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   TextInfo^ myTI = MyCI->TextInfo;
   
   // Changes a String* to lowercase.
   Console::WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI->ToLower( myString ) );
   
   // Changes a String* to uppercase.
   Console::WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI->ToUpper( myString ) );
   
   // Changes a String* to titlecase.
   Console::WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI->ToTitleCase( myString ) );
}

/*
This code produces the following output.

S"wAr aNd pEaCe" to lowercase: war and peace
S"wAr aNd pEaCe" to uppercase: WAR AND PEACE
S"wAr aNd pEaCe" to titlecase: War And Peace

*/
using System;
using System.Globalization;


public class SamplesTextInfo  {

   public static void Main()  {

      // Defines the string with mixed casing.
      string myString = "wAr aNd pEaCe";

      // Creates a TextInfo based on the "en-US" culture.
      TextInfo myTI = new CultureInfo("en-US",false).TextInfo;

      // Changes a string to lowercase.
      Console.WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI.ToLower( myString ) );

      // Changes a string to uppercase.
      Console.WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI.ToUpper( myString ) );

      // Changes a string to titlecase.
      Console.WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI.ToTitleCase( myString ) );

   }

}

/*
This code produces the following output.

"wAr aNd pEaCe" to lowercase: war and peace
"wAr aNd pEaCe" to uppercase: WAR AND PEACE
"wAr aNd pEaCe" to titlecase: War And Peace

*/
Imports System.Globalization

Public Class SamplesTextInfo

   Public Shared Sub Main()

      ' Defines the string with mixed casing.
      Dim myString As String = "wAr aNd pEaCe"

      ' Creates a TextInfo based on the "en-US" culture.
      Dim myTI As TextInfo = New CultureInfo("en-US", False).TextInfo

      ' Changes a string to lowercase.
      Console.WriteLine("""{0}"" to lowercase: {1}", myString, myTI.ToLower(myString))

      ' Changes a string to uppercase.
      Console.WriteLine("""{0}"" to uppercase: {1}", myString, myTI.ToUpper(myString))

      ' Changes a string to titlecase.
      Console.WriteLine("""{0}"" to titlecase: {1}", myString, myTI.ToTitleCase(myString))

   End Sub

End Class


'This code produces the following output.
'
'"wAr aNd pEaCe" to lowercase: war and peace
'"wAr aNd pEaCe" to uppercase: WAR AND PEACE
'"wAr aNd pEaCe" to titlecase: War And Peace


注釈

大文字と小文字のセマンティクスは、使用されているカルチャによって異なります。Casing semantics depend on the culture in use. インバリアントカルチャでは、大文字と小文字のセマンティクスはカルチャに依存しません。For the invariant culture, the casing semantics are not culture-sensitive. 特定のカルチャでは、大文字と小文字の区別はそのカルチャに依存します。For a specific culture, the casing semantics are sensitive to that culture.

セキュリティの決定が文字列比較または大文字と小文字の変更操作に依存しているInvariantCulture場合、アプリケーションはを使用して、システムのカルチャ設定に関係なく動作が一貫していることを確認する必要があります。If a security decision depends on a string comparison or a case-change operation, the application should use the InvariantCulture to ensure that the behavior is consistent regardless of the culture settings of the system. ただし、インバリアントカルチャは、カルチャに依存しない結果 (システムサービスなど) を必要とするプロセスでのみ使用する必要があります。However, the invariant culture must be used only by processes that require culture-independent results, such as system services. それ以外の場合は、言語が正しくないか、カルチャが不適切である可能性のある結果が生成されます。Otherwise, it produces results that might be linguistically incorrect or culturally inappropriate.

カルチャの詳細についてはCultureInfo、「」を参照してください。For more information on cultures, see CultureInfo.

こちらもご覧ください

ToLower(String)

指定した文字列を小文字に変換します。Converts the specified string to lowercase.

public:
 virtual System::String ^ ToLower(System::String ^ str);
public virtual string ToLower (string str);
abstract member ToLower : string -> string
override this.ToLower : string -> string
Public Overridable Function ToLower (str As String) As String

パラメーター

str
String

小文字に変換する文字列。The string to convert to lowercase.

戻り値

小文字に変換するために指定する文字列。The specified string converted to lowercase.

例外

str が null です。str is null.

次のコード例では、英語 (米国) カルチャに基づいた文字列の大文字と小文字の区別を、カルチャ名 en-us で変更します。The following code example changes the casing of a string based on the English (United States) culture, with the culture name en-US.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the String* with mixed casing.
   String^ myString = "wAr aNd pEaCe";
   
   // Creates a TextInfo based on the S"en-US" culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   TextInfo^ myTI = MyCI->TextInfo;
   
   // Changes a String* to lowercase.
   Console::WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI->ToLower( myString ) );
   
   // Changes a String* to uppercase.
   Console::WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI->ToUpper( myString ) );
   
   // Changes a String* to titlecase.
   Console::WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI->ToTitleCase( myString ) );
}

/*
This code produces the following output.

S"wAr aNd pEaCe" to lowercase: war and peace
S"wAr aNd pEaCe" to uppercase: WAR AND PEACE
S"wAr aNd pEaCe" to titlecase: War And Peace

*/
using System;
using System.Globalization;


public class SamplesTextInfo  {

   public static void Main()  {

      // Defines the string with mixed casing.
      string myString = "wAr aNd pEaCe";

      // Creates a TextInfo based on the "en-US" culture.
      TextInfo myTI = new CultureInfo("en-US",false).TextInfo;

      // Changes a string to lowercase.
      Console.WriteLine( "\"{0}\" to lowercase: {1}", myString, myTI.ToLower( myString ) );

      // Changes a string to uppercase.
      Console.WriteLine( "\"{0}\" to uppercase: {1}", myString, myTI.ToUpper( myString ) );

      // Changes a string to titlecase.
      Console.WriteLine( "\"{0}\" to titlecase: {1}", myString, myTI.ToTitleCase( myString ) );

   }

}

/*
This code produces the following output.

"wAr aNd pEaCe" to lowercase: war and peace
"wAr aNd pEaCe" to uppercase: WAR AND PEACE
"wAr aNd pEaCe" to titlecase: War And Peace

*/
Imports System.Globalization

Public Class SamplesTextInfo

   Public Shared Sub Main()

      ' Defines the string with mixed casing.
      Dim myString As String = "wAr aNd pEaCe"

      ' Creates a TextInfo based on the "en-US" culture.
      Dim myTI As TextInfo = New CultureInfo("en-US", False).TextInfo

      ' Changes a string to lowercase.
      Console.WriteLine("""{0}"" to lowercase: {1}", myString, myTI.ToLower(myString))

      ' Changes a string to uppercase.
      Console.WriteLine("""{0}"" to uppercase: {1}", myString, myTI.ToUpper(myString))

      ' Changes a string to titlecase.
      Console.WriteLine("""{0}"" to titlecase: {1}", myString, myTI.ToTitleCase(myString))

   End Sub

End Class


'This code produces the following output.
'
'"wAr aNd pEaCe" to lowercase: war and peace
'"wAr aNd pEaCe" to uppercase: WAR AND PEACE
'"wAr aNd pEaCe" to titlecase: War And Peace


注釈

返される文字列は、入力文字列の長さが異なる場合があります。The returned string might differ in length from the input string. 大文字と小文字の区別の詳細については、unicodeコンソーシアムによって公開されている Unicode テクニカルレポート #21 「ケースマッピング」を参照してください。For more information on casing, refer to the Unicode Technical Report #21 "Case Mappings," published by the Unicode Consortium. 現在の実装では、文字列の長さが保持されます。The current implementation preserves the length of the string. ただし、この動作は保証されず、将来の実装で変更される可能性があります。However, this behavior is not guaranteed and could change in future implementations.

大文字と小文字のセマンティクスは、使用されているカルチャによって異なります。Casing semantics depend on the culture in use. インバリアントカルチャでは、大文字と小文字のセマンティクスはカルチャに依存しません。For the invariant culture, the casing semantics are not culture-sensitive. 特定のカルチャでは、大文字と小文字の区別はそのカルチャに依存します。For a specific culture, the casing semantics are sensitive to that culture.

セキュリティの決定が文字列比較または大文字と小文字の変更操作に依存しているInvariantCulture場合、アプリケーションはを使用して、システムのカルチャ設定に関係なく動作が一貫していることを確認する必要があります。If a security decision depends on a string comparison or a case-change operation, the application should use the InvariantCulture to ensure that the behavior is consistent regardless of the culture settings of the system. ただし、インバリアントカルチャは、カルチャに依存しない結果 (システムサービスなど) を必要とするプロセスでのみ使用する必要があります。However, the invariant culture must be used only by processes that require culture-independent results, such as system services. それ以外の場合は、言語が正しくないか、カルチャが不適切である可能性のある結果が生成されます。Otherwise, it produces results that might be linguistically incorrect or culturally inappropriate.

カルチャの詳細についてはCultureInfo、「」を参照してください。For more information on cultures, see CultureInfo.

こちらもご覧ください

適用対象