TextInfo.ToTitleCase-Methode

Wandelt die angegebene Zeichenfolge in Schreibung mit großem Anfangsbuchstaben um.

Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function ToTitleCase ( _
    str As String _
) As String
'Usage
Dim instance As TextInfo
Dim str As String
Dim returnValue As String

returnValue = instance.ToTitleCase(str)

public string ToTitleCase (
    string str
)

public:
String^ ToTitleCase (
    String^ str
)

public String ToTitleCase (
    String str
)

public function ToTitleCase (
    str : String
) : String

Parameter

• str
  Die in Schreibung mit großem Anfangsbuchstaben umzuwandelnde Zeichenfolge.

Rückgabewert

Die in Schreibung mit großem Anfangsbuchstaben konvertierte angegebene Zeichenfolge.

Ausnahmen

Hinweise

In der Regel werden bei der Schreibung mit großem Anfangsbuchstaben das erste Zeichen eines Wortes in Großbuchstaben und die restlichen Zeichen in Kleinbuchstaben konvertiert. Ein Wort, das ausschließlich aus Großbuchstaben besteht, z. B. ein Akronym, wird jedoch nicht konvertiert.

Die aktuelle Implementierung der ToTitleCase-Methode ergibt eine Ausgabezeichenfolge mit derselben Länge wie die Eingabezeichenfolge. Dieses Verhalten kann jedoch nicht garantiert werden und kann sich in zukünftigen Implementierungen ändern.

Weitere Informationen über Groß- und Kleinschreibung finden Sie im Unicode Technical Report Nr. 21, "Case Mappings", unter (nur auf Englisch verfügbar).

Beispiel

Im folgenden Codebeispiel wird die Groß- bzw. Kleinschreibung einer Zeichenfolge auf der Grundlage der Kultur "en-US" geändert.

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

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

*/

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

*/

import System.*;
import System.Globalization.*;

public class SamplesTextInfo
{   
    public static void main(String[] args)
    {
        // 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)).get_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));
    } //main
} //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

*/

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextInfo-Klasse
TextInfo-Member
System.Globalization-Namespace
ToLower
ToUpper