TextInfo.ToTitleCase(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Převede zadaný řetězec na velká písmena (s výjimkou slov, která jsou zcela velká, která jsou považována za akronymy).
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
Parametry
- str
- String
Řetězec, který má být převeden na název Case.
Návraty
Zadaný řetězec převedený na velká písmena.
Výjimky
str
je null
.
Příklady
Následující příklad změní velikost písmen řetězce na základě jazykové verze anglické (USA), s názvem jazykové verze 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
Následující příklad předává každý řetězec v poli do ToTitleCase metody. Řetězce obsahují správné řetězce nadpisu i akronymy. Řetězce jsou převedeny na případ názvů pomocí konvencí jazykové verze 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
Poznámky
Obecně platí, že velikost písmen v nadpisu převede první znak slova na velká písmena a zbytek znaků na malá písmena. Tato metoda ale v současné době neposkytuje správné používání velkých a malých písmen, jako je například akronym. Následující tabulka ukazuje způsob, jakým Metoda vykresluje několik řetězců.
Vstup | Jazyk | Očekávaný výsledek | Skutečný výsledek |
---|---|---|---|
války a mír | Angličtina | Války a mír | Války a mír |
Za Anhalter durch die Galaxis | Němčina | Za Anhalter durch die Galaxis | Za Anhalter durch die Galaxis |
Les naufragés d'ythaq | Francouzština | Les Naufragés d'Ythaq | Les Naufragés D'ythaq |
Jak je znázorněno výše, ToTitleCase Metoda poskytuje libovolné chování velkých a malých písmen, což není nutně lingvisticky správné. Lingvisticky správné řešení by vyžadovalo další pravidla a aktuální algoritmus je trochu jednodušší a rychlejší. Vyhrazujeme si právo, aby toto rozhraní API bylo během budoucna pomalejší.
Aktuální implementace ToTitleCase metody vrací výstupní řetězec, který má stejnou délku jako vstupní řetězec. Toto chování se ale nezaručuje a v budoucí implementaci se může změnit.