TextInfo.ToTitleCase(String) Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

Source:

TextInfo.cs

Converte a cadeia de caracteres especificada em capitalização de título (exceto palavras que têm todas as letras maiúsculas, consideradas acrônimos).

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

Parâmetros

str

String

A cadeia de caracteres a ser convertida para capitalização de título.

Retornos

String

A cadeia de caracteres especificada é convertida em capitalização de título.

Exceções

ArgumentNullException

str é null.

Exemplos

O exemplo a seguir altera o uso de maiúsculas e minúsculas de uma cadeia de caracteres com base na cultura em inglês (Estados Unidos), com o nome da cultura 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

O exemplo a seguir passa todas as cadeias de caracteres de uma matriz para o método ToTitleCase. As cadeias de caracteres incluem cadeias de caracteres de títulos próprios assim como acrônimos. As cadeias de caracteres são convertidas em maiúsculas e minúsculas usando as convenções da 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

Comentários

Em geral, a maiúsculas e minúsculas converte o primeiro caractere de uma palavra em maiúsculas e o restante dos caracteres em minúsculas. No entanto, esse método atualmente não fornece maiúsculas e minúsculas adequadas para converter uma palavra totalmente maiúscula, como um acrônimo. A tabela a seguir mostra como o método renderiza várias cadeias de caracteres.

Entrada	Idioma	Resultado esperado	Resultado real
guerra e paz	Inglês	Guerra e Paz	Guerra e Paz
Per anhalter durch die Galaxis	Alemão	Per Anhalter durch die Galaxis	Por Anhalter Durch Die Galaxis
les naufragés d'ythaq	Francês	Les Naufragés d'Ythaq	Les Naufragés D'ythaq

Conforme ilustrado acima, o ToTitleCase método fornece um comportamento arbitrário de maiúsculas e minúsculas que não é necessariamente linguisticamente correto. Uma solução linguisticamente correta exigiria regras adicionais e o algoritmo atual é um pouco mais simples e rápido. Reservamos o direito de tornar essa API mais lenta no futuro.

A implementação atual do ToTitleCase método produz uma cadeia de caracteres de saída que tem o mesmo comprimento que a cadeia de caracteres de entrada. No entanto, esse comportamento não é garantido e pode mudar em uma implementação futura.

Confira também

• ToLower(Char)
• ToUpper(Char)