TextInfo.ToTitleCase(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit la chaîne spécifiée en une chaîne avec la première lettre des mots en majuscule (excepté pour les mots qui sont entièrement en majuscules, lesquels sont considérés comme des acronymes).
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
Paramètres
- str
- String
Chaîne à convertir en chaîne avec la première lettre des mots en majuscule.
Retours
Chaîne spécifiée convertie en chaîne avec la première lettre des mots en majuscule.
Exceptions
str
a la valeur null
.
Exemples
L’exemple suivant modifie la casse d’une chaîne en fonction de la culture anglaise (États-Unis), avec le nom de la culture 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
L'exemple suivant passe chaque chaîne d'un tableau à la méthode ToTitleCase. Les chaînes incluent des chaînes de titre appropriées, ainsi que des acronymes. Les chaînes sont converties en cas de titre à l’aide des conventions de la culture 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
Remarques
En règle générale, la casse de titre convertit le premier caractère d’un mot en majuscules et le reste des caractères en minuscules. Toutefois, cette méthode ne fournit pas actuellement une casse appropriée pour convertir un mot entièrement majuscule, tel qu’un acronyme. Le tableau suivant montre comment la méthode affiche plusieurs chaînes.
Entrée | Langage | Résultat attendu | Résultat réel |
---|---|---|---|
guerre et paix | Anglais | Guerre et paix | Guerre et paix |
Per anhalter durch die Galaxis | Allemand | Per Anhalter durch die Galaxis | Per Anhalter Durch Die Galaxis |
les naufragés d’ythaq | Français | Les Naufragés d’Ythaq | Les Naufragés D’ythaq |
Comme illustré ci-dessus, la ToTitleCase méthode fournit un comportement de casse arbitraire qui n’est pas nécessairement correct sur le plan linguistique. Une solution linguistiquement correcte nécessiterait des règles supplémentaires, et l’algorithme actuel est un peu plus simple et plus rapide. Nous nous réservons le droit de ralentir cette API à l’avenir.
L’implémentation actuelle de la ToTitleCase méthode génère une chaîne de sortie de la même longueur que la chaîne d’entrée. Toutefois, ce comportement n’est pas garanti et pourrait changer dans une implémentation ultérieure.