資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TextInfo.ToTitleCase 方法

將指定的字串轉換為字首大寫 (除了視為縮略字的完全大寫文字例外)。

命名空間:  System.Globalization
組件:  mscorlib (在 mscorlib.dll 中)

public string ToTitleCase(
	string str
)

參數

str
類型:System.String
要轉換為字首大寫的字串。

傳回值

類型:System.String
轉換為字首大寫的指定字串。

例外狀況條件
ArgumentNullException

strnull

一般說來,字首大寫會將文字的第一個字元轉換為大寫,而將其餘字元轉換為小寫。 不過,這個方法目前並未提供適當的大小寫可轉換完全大寫的字,例如縮略字。 下表顯示方法呈現數個字串的方式。

輸入

語言

預期的結果

實際的結果

war and peace

英文

War and Peace

War And Peace

Per anhalter durch die Galaxis

德文

Per Anhalter durch die Galaxis

Per Anhalter Durch Die Galaxis

les naufragés d'ythaq

法文

Les Naufragés d'Ythaq

Les Naufragés D'ythaq

如上方所示,ToTitleCase 方法提供任意大小寫的行為,其不一定要語法正確。 語法正確的解決方案會需要額外的規則,而目前的演算法更簡單且更快。 我們保留未來減緩此 API 速度的權利。

ToTitleCase 方法目前的實作 (Implementation) 會產生長度與輸入字串相同的輸出字串。 不過,在未來實作中不保證有這項行為,而且可能變更。

下列範例會變更以英文 (美國) 文化特性的字串的大小寫,與文化特性名稱 en-US。


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

*/


下列範例會經由 ToTitleCase 方法在陣列中的每一個字串。 字串包含適當標頭字串以及縮略字。 使用 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


.NET Framework

支援版本:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

支援版本:4、3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (不支援伺服器核心角色), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心角色,不支援 Itanium)

.NET Framework 並不支援各種平台的所有版本。如需支援版本的清單,請參閱.NET Framework 系統需求

社群新增項目

顯示:
© 2014 Microsoft