TextInfo.ToTitleCase(String) Metoda

Definice

Obor názvů:

System.Globalization

Sestavení:

System.Runtime.dll

Zdroj:

TextInfo.cs

Převede zadaný řetězec na velká a malá písmena názvu (s výjimkou slov, která jsou celá velká a která jsou považována za zkratky).

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ý se má převést na velká a malá písmena názvu.

Návraty

String

Zadaný řetězec byl převeden na velká písmena názvu.

Výjimky

ArgumentNullException

str je null.

Příklady

Následující příklad změní velikost písmen řetězce na základě anglické jazykové verze (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á každý řetězec v poli metodě ToTitleCase . Řetězce obsahují správné řetězce názvů i akronymy. Řetězce se převedou na velká a malá písmena názvu 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 použití velkých písmen nadpisu převede první znak slova na velká písmena a zbytek znaků na malá písmena. Tato metoda však v současné době neposkytuje správnou velikost písmen pro převod slova, které je zcela velkými písmeny, 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álka a mír	Angličtina	Válka a mír	Válka a mír
Per anhalter durch die Galaxies	Němčina	Per Anhalter durch die Galaxies	Per Anhalter Durch Die Galaxies
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 chování s libovolnými velikostmi a velikostmi, které nemusí být nutně jazykově správné. Lingvisticky správné řešení by vyžadovalo další pravidla a současný algoritmus je o něco jednodušší a rychlejší. Vyhrazujeme si právo toto rozhraní API v budoucnu zpomalit.

Aktuální implementace ToTitleCase metody poskytuje výstupní řetězec, který má stejnou délku jako vstupní řetězec. Toto chování však není zaručeno a může se změnit v budoucí implementaci.

Viz také

• ToLower(Char)
• ToUpper(Char)