TextInfo.ToTitleCase メソッド

指定した文字列をタイトル文字に変換します。

Public Function ToTitleCase( _
   ByVal str As String _) As String
[C#]
public string ToTitleCase(stringstr);
[C++]
public: String* ToTitleCase(String* str);
[JScript]
public function ToTitleCase(
   str : String) : String;

パラメータ

• str
  タイトル文字に変換する文字列。

戻り値

タイトル文字に変換するために指定する文字列。

例外

例外の種類	条件
ArgumentNullException	str が null 参照 (Visual Basic では Nothing) です。

解説

タイトル文字に変換することにより、通常、単語の最初の文字が大文字に変換され、残りの文字は小文字に変換されます。

返された文字列は、入力文字列とは長さが異なる場合があります。大文字と小文字の区別については、Unicode Consortium (http://www.unicode.org) が発行している『Unicode Technical Report #21』の「Case Mappings」を参照してください。現在の実装は文字列の長さを保持しますが、この動作は保証されておらず、将来の実装では変更される場合があります。

大文字と小文字の区別は、使用するカルチャによって異なります。インバリアント カルチャを使用する場合、大文字と小文字の区別は、そのカルチャに応じて決まるわけではありません。特定のカルチャを使用する場合、大文字と小文字の区別は、そのカルチャに応じて決まります。タイトル文字への変換のために選択される単語は言語に依存します。

セキュリティの決定が文字列の比較や大文字/小文字の変換操作に依存する場合は、システムのカルチャ設定にかかわらず一定の動作を保証するために InvariantCulture を使用してください。ただし、インバリアント カルチャは、システム サービスなど、カルチャに依存しない結果を必要とするプロセスでだけ使用する必要があります。それ以外の場合に使用すると、言語として正しくない、またはカルチャに対して不適切な結果が生じます。

カルチャの詳細については、 CultureInfo のトピックを参照してください。

使用例

[Visual Basic, C#, C++] "en-US" カルチャを基に、文字列の大文字/小文字の区別規則を変更する例を次に示します。

 
Imports System
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 'Main 

End Class 'SamplesTextInfo


'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



[C#] 
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

*/

[C++] 
#using <mscorlib.dll>
using namespace System;
using namespace System::Globalization;

int main()
{
   // Defines the String* with mixed casing.
   String* myString = S"wAr aNd pEaCe";

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

   // Changes a String* to lowercase.
   Console::WriteLine(S"\"{0}\" to lowercase: {1}", myString, myTI -> ToLower(myString));

   // Changes a String* to uppercase.
   Console::WriteLine(S"\"{0}\" to uppercase: {1}", myString, myTI -> ToUpper(myString));

   // Changes a String* to titlecase.
   Console::WriteLine(S"\"{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

*/

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

TextInfo クラス | TextInfo メンバ | System.Globalization 名前空間 | ToLower | ToUpper