TextInfo::ToTitleCase Method
Converts the specified string to titlecase.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- str
- Type: System::String
The string to convert to titlecase.
| Exception | Condition |
|---|---|
| ArgumentNullException | str is null. |
Generally, title casing converts the first character of a word to uppercase and the rest of the characters to lowercase. However, this method does not currently provide proper casing to convert a word that is entirely uppercase, such as an acronym. The following table shows the way the method renders several strings.
Input | Language | Expected result | Actual result |
|---|---|---|---|
war and peace | English | War and Peace | War And Peace |
Per anhalter durch die Galaxis | German | Per Anhalter durch die Galaxis | Per Anhalter Durch Die Galaxis |
les naufragés d'ythaq | French | Les Naufragés d'Ythaq | Les Naufragés D'ythaq |
As illustrated above, the ToTitleCase method provides an arbitrary casing behavior which is not necessarily linguistically correct. A linguistically correct solution would require additional rules, and the current algorithm is somewhat simpler and faster. We reserve the right to make this API slower in the future.
The current implementation of the ToTitleCase method yields an output string that is the same length as the input string. However, this behavior is not guaranteed and could change in a future implementation.
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 */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.