TextInfo.ToTitleCase(String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Globalization
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
TextInfo.cs
Source:
TextInfo.cs
Source:
TextInfo.cs

Converte la stringa specificata nella combinazione con tutte le iniziali maiuscole, eccetto le parole costituite interamente da lettere maiuscole, che sono considerate acronimi.

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

Parametri

str
String

Stringa da convertire nella combinazione di maiuscole e minuscole dei titoli.

Restituisce

String

Stringa specificata convertita nella combinazione con tutte le iniziali maiuscole.

Eccezioni

ArgumentNullException

str è null.

Esempio

Nell'esempio seguente vengono modificate le maiuscole e le minuscole di una stringa basata sulle impostazioni cultura Inglese (Stati Uniti) con il relativo nome 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

Nell'esempio, ogni stringa di una matrice viene passata al metodo ToTitleCase. Nelle stringhe sono incluse le stringhe corrette dei titoli e gli acronimi. Le stringhe vengono convertite in maiuscole utilizzando le convenzioni delle impostazioni cultura 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

Commenti

In genere, la combinazione di maiuscole e minuscole converte il primo carattere di una parola in maiuscolo e il resto dei caratteri in minuscolo. Tuttavia, questo metodo attualmente non fornisce maiuscole e minuscole appropriate per convertire una parola interamente maiuscola, ad esempio un acronimo. Nella tabella seguente viene illustrato il modo in cui il metodo esegue il rendering di più stringhe.

Input Linguaggio Risultato previsto Risultato effettivo
guerra e pace Inglese Guerra e pace Guerra e pace
Per anhalter durch die Galaxis Tedesco Per Anhalter durch die Galaxis Per Anhalter Durch Die Galaxis
les naufragés d'ythaq Francese Les Naufragés d'Ythaq Les Naufragés D'ythaq

Come illustrato in precedenza, il ToTitleCase metodo fornisce un comportamento arbitrario di maiuscole e minuscole che non è necessariamente corretto in modo linguistico. Una soluzione linguisticamente corretta richiede regole aggiuntive e l'algoritmo corrente è leggermente più semplice e veloce. Si riserva il diritto di rallentare questa API in futuro.

L'implementazione corrente del ToTitleCase metodo restituisce una stringa di output con la stessa lunghezza della stringa di input. Tuttavia, questo comportamento non è garantito e potrebbe cambiare in un'implementazione futura.

Si applica a

Vedi anche