TextInfo.ToTitleCase(String) Metode

Definisi

Ruang nama:

System.Globalization

Rakitan:

System.Runtime.dll

Sumber:

TextInfo.cs

Mengonversi string yang ditentukan menjadi huruf besar/kecil (kecuali untuk kata-kata yang sepenuhnya dalam huruf besar, yang dianggap sebagai akronim).

public:
 System::String ^ ToTitleCase(System::String ^ str);

public string ToTitleCase (string str);

member this.ToTitleCase : string -> string

Public Function ToTitleCase (str As String) As String

Parameter

str

String

String yang akan dikonversi ke huruf besar/kecil.

Mengembalikan

String

String yang ditentukan dikonversi menjadi huruf besar/kecil.

Pengecualian

ArgumentNullException

stradalah null.

Contoh

Contoh berikut mengubah casing string berdasarkan budaya Bahasa Inggris (Amerika Serikat), dengan nama budaya 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

Contoh berikut meneruskan setiap string dalam array ke metode ToTitleCase. String menyertakan string judul yang tepat serta akronim. String dikonversi menjadi huruf besar/kecil dengan menggunakan konvensi budaya en-US.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { "a tale of two cities", "gROWL to the rescue",
                          "inside the US government", "sports and MLB baseball",
                          "The Return of Sherlock Holmes", "UNICEF and children"};

      TextInfo ti = CultureInfo.CurrentCulture.TextInfo;
      foreach (var value in values)
         Console.WriteLine("{0} --> {1}", value, ti.ToTitleCase(value));
   }
}
// The example displays the following output:
//    a tale of two cities --> A Tale Of Two Cities
//    gROWL to the rescue --> Growl To The Rescue
//    inside the US government --> Inside The US Government
//    sports and MLB baseball --> Sports And MLB Baseball
//    The Return of Sherlock Holmes --> The Return Of Sherlock Holmes
//    UNICEF and children --> UNICEF And Children

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { "a tale of two cities", "gROWL to the rescue",
                                 "inside the US government", "sports and MLB baseball",
                                 "The Return of Sherlock Holmes", "UNICEF and children"}
                                 
      Dim ti As TextInfo = CultureInfo.CurrentCulture.TextInfo
      For Each value In values
         Console.WriteLine("{0} --> {1}", value, ti.ToTitleCase(value))
      Next
   End Sub
End Module
' The example displays the following output:
'    a tale of two cities --> A Tale Of Two Cities
'    gROWL to the rescue --> Growl To The Rescue
'    inside the US government --> Inside The US Government
'    sports and MLB baseball --> Sports And MLB Baseball
'    The Return of Sherlock Holmes --> The Return Of Sherlock Holmes
'    UNICEF and children --> UNICEF And Children

Keterangan

Umumnya, huruf besar judul mengonversi karakter pertama kata menjadi huruf besar dan karakter lainnya menjadi huruf kecil. Namun, metode ini saat ini tidak menyediakan casing yang tepat untuk mengonversi kata yang sepenuhnya huruf besar, seperti akronim. Tabel berikut ini memperlihatkan cara metode merender beberapa string.

Input	Bahasa	Hasil yang diharapkan	Hasil aktual
perang dan perdamaian	Inggris	Perang dan Perdamaian	Perang dan Perdamaian
Per anhalter durch die Galaxis	Jerman	Per Anhalter durch die Galaxis	Per Anhalter Durch Die Galaxis
les naufragés d'ythaq	Prancis	Les Naufragés d'Ythaq	Les Naufragés D'ythaq

Seperti yang diilustrasikan di atas, ToTitleCase metode ini menyediakan perilaku casing arbitrer yang belum tentu benar secara linguistik. Solusi yang benar secara linguistik akan memerlukan aturan tambahan, dan algoritma saat ini agak lebih sederhana dan lebih cepat. Kami berhak untuk membuat API ini lebih lambat di masa mendatang.

Implementasi ToTitleCase metode saat ini menghasilkan string output dengan panjang yang sama dengan string input. Namun, perilaku ini tidak dijamin dan dapat berubah dalam implementasi di masa mendatang.

Lihat juga

• ToLower(Char)
• ToUpper(Char)