System.Globalization.TextInfo.ToTitleCase Method

Converts the specified string to title case (except for words that are entirely in uppercase, which are considered to be acronyms)..

Syntax

public string ToTitleCase (string str)

Parameters

str
The string to convert to title case.

Returns

The specified string converted to title case.

Remarks

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.

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 TextInfo.ToTitleCase(string) 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 TextInfo.ToTitleCase(string) 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.

Requirements

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0