TextInfo.ToTitleCase(String) Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Źródło:

TextInfo.cs

Konwertuje określony ciąg na przypadek tytułu (z wyjątkiem wyrazów, które są całkowicie wielkie, które są uważane za akronimy).

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

Ciąg, który ma być konwertowany na wielkość liter tytułu.

Zwraca

String

Określony ciąg przekonwertowany na przypadek tytułu.

Wyjątki

ArgumentNullException

str to null.

Przykłady

Poniższy przykład zmienia wielkość liter ciągu na podstawie kultury angielskiej (Stany Zjednoczone) z nazwą kultury 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

Poniższy przykład przekazuje każdy ciąg w tablicy do ToTitleCase metody . Ciągi zawierają prawidłowe ciągi tytułu, a także akronimy. Ciągi są konwertowane na przypadek tytułu przy użyciu konwencji kultury 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

Uwagi

Ogólnie rzecz biorąc, wielkość liter tytułu konwertuje pierwszy znak wyrazu na wielkie litery, a pozostałe znaki na małe litery. Jednak ta metoda nie zapewnia obecnie właściwej wielkości liter w celu przekonwertowania wyrazu, który jest całkowicie wielkimi literami, na przykład akronimem. W poniższej tabeli przedstawiono sposób renderowania kilku ciągów przez metodę .

Dane wejściowe	Język	Oczekiwany wynik	Rzeczywisty wynik
wojna i pokój	Angielski	Wojna i pokój	Wojna i pokój
Per anhalter durch die Galaxis	Niemiecki	Per Anhalter durch die Galaxis	Per Anhalter Durch Die Galaxis
les naufragés d'ythaq	Francuski	Les Naufragés d'Ythaq	Les Naufragés D'ythaq

Jak pokazano powyżej, ToTitleCase metoda zapewnia dowolne zachowanie wielkości liter, które niekoniecznie jest poprawne lingwistyczne. Poprawne lingwistyczne rozwiązanie wymagałoby dodatkowych reguł, a bieżący algorytm jest nieco prostszy i szybszy. Zastrzegamy sobie prawo do wolniejszego działania tego interfejsu API w przyszłości.

Bieżąca implementacja ToTitleCase metody zwraca ciąg wyjściowy o tej samej długości co ciąg wejściowy. Jednak to zachowanie nie jest gwarantowane i może ulec zmianie w przyszłej implementacji.

Zobacz też

• ToLower(Char)
• ToUpper(Char)