TextInfo.ToTitleCase(String) TextInfo.ToTitleCase(String) TextInfo.ToTitleCase(String) TextInfo.ToTitleCase(String) Method

Definition

Konvertiert die angegebene Zeichenfolge in große Anfangsbuchstaben (außer Wörtern, die vollständig in Großbuchstaben geschrieben sind, die als Akronyme betrachtet werden).Converts the specified string to title case (except for words that are entirely in uppercase, which are considered to be acronyms).

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

Parameter

str
String String String String

Die in Schreibung mit großem Anfangsbuchstaben umzuwandelnde Zeichenfolge.The string to convert to title case.

Gibt zurück

Die in Schreibung mit großem Anfangsbuchstaben konvertierte angegebene Zeichenfolge.The specified string converted to title case.

Ausnahmen

Beispiele

Im folgende Beispiel ändert die Groß-/Kleinschreibung einer Zeichenfolge, die entsprechend der Kultur Englisch (Vereinigte Staaten), mit der Kultur En-US.The following 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

*/
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
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 'Main 

End Class 'SamplesTextInfo


'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


Im folgenden Beispiel wird jede Zeichenfolge in einem Array an die ToTitleCase-Methode übergeben.The following example passes each string in an array to the ToTitleCase method. Die Zeichenfolgen enthalten sowohl Titelzeichenfolgen als auch Akronyme.The strings include proper title strings as well as acronyms. Die Zeichenfolgen werden in titelschreibung konvertiert, mithilfe der Konventionen der Kultur En-US.The strings are converted to title case by using the conventions of the en-US culture.

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

Hinweise

Im Allgemeinen konvertiert titelschreibweise das erste Zeichen eines Worts in Großbuchstaben und die restlichen Zeichen in Kleinbuchstaben.Generally, title casing converts the first character of a word to uppercase and the rest of the characters to lowercase. Allerdings bietet diese Methode zurzeit keine entsprechenden Groß-/Kleinschreibung, um ein Wort konvertieren, die ausschließlich aus Großbuchstaben besteht, wie z. B. ein Akronym ist.However, this method does not currently provide proper casing to convert a word that is entirely uppercase, such as an acronym. Die folgende Tabelle zeigt, dass die Methode mehrere Zeichenfolgen gerendert.The following table shows the way the method renders several strings.

EingabeInput SpracheLanguage Erwartetes ErgebnisExpected result Tatsächliches ErgebnisActual result
Krieg und Friedenwar and peace EnglischEnglish Krieg und FriedenWar and Peace Krieg und FriedenWar And Peace
Pro Anhalter Durch Die GalaxisPer anhalter durch die Galaxis DeutschGerman Pro Anhalter Durch Die GalaxisPer Anhalter durch die Galaxis Pro Anhalter Durch Die GalaxisPer Anhalter Durch Die Galaxis
les naufragés d'ythaqles naufragés d'ythaq FranzösischFrench Les Naufragés d'YthaqLes Naufragés d'Ythaq Les Naufragés D'ythaqLes Naufragés D'ythaq

Wie oben gezeigt die ToTitleCase Methode stellt eine beliebige Schreibweise Verhalten handelt es sich nicht unbedingt linguistisch korrekte bereit.As illustrated above, the ToTitleCase method provides an arbitrary casing behavior which is not necessarily linguistically correct. Eine linguistisch korrekte Lösung benötigt zusätzliche Regeln, und der aktuelle Algorithmus ist ein wenig einfacher und schneller.A linguistically correct solution would require additional rules, and the current algorithm is somewhat simpler and faster. Wir behalten uns das Recht, diese API langsamer in der Zukunft.We reserve the right to make this API slower in the future.

Die aktuelle Implementierung von der ToTitleCase Methode liefert eine Ausgabezeichenfolge, die die gleiche Länge wie der Eingabezeichenfolge steht.The current implementation of the ToTitleCase method yields an output string that is the same length as the input string. Allerdings wird dieses Verhalten ist nicht garantiert und in einer zukünftigen Implementierung ändern kann.However, this behavior is not guaranteed and could change in a future implementation.

Gilt für:

Siehe auch