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

정의

지정된 문자열에서 단어의 첫 글자를 대문자로 변환합니다(약어로 간주되는 모두 대문자로 이루어진 단어 제외).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

매개 변수

str
String String String String

첫 글자만 대문자로 변환할 문자열입니다.The string to convert to title case.

반환

첫 글자만 대문자로 변환된 지정된 문자열입니다.The specified string converted to title case.

예외

예제

다음 예제에서는 문화권 이름은 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.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


다음 예제에서는 배열의 각 문자열을 ToTitleCase 메서드에 전달합니다.The following example passes each string in an array to the ToTitleCase method. 문자열에는 적절한 제목 문자열과 머리글자어가 포함됩니다.The strings include proper title strings as well as acronyms. 문자열은 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

설명

일반적으로 첫 글자를 대문자로 된 단어의 첫 번째 문자 및 나머지 문자를 소문자로 변환 합니다.Generally, title casing converts the first character of a word to uppercase and the rest of the characters to lowercase. 그러나이 메서드는 현재 머리글자어와 같이 전체적으로 대문자 단어를 변환 하려면 적절 한 대/소문자를 제공 하지 않습니다.However, this method does not currently provide proper casing to convert a word that is entirely uppercase, such as an acronym. 다음 표에서 여러 문자열을 렌더링 하는 방식으로 메서드를 보여 줍니다.The following table shows the way the method renders several strings.

입력Input 언어Language 예상된 결과Expected result 실제 결과Actual result
전쟁과 평화war and peace 영어English 전쟁과 평화War and Peace 전쟁과 평화War And Peace
Anhalter durch 주사위 Galaxis 당Per anhalter durch die Galaxis 독일어German Anhalter durch 주사위 Galaxis 당Per Anhalter durch die Galaxis Anhalter Durch 주사위 Galaxis 당Per Anhalter Durch Die Galaxis
les naufragés d'ythaqles naufragés d'ythaq 프랑스어French Les Naufragés d'YthaqLes Naufragés d'Ythaq Les Naufragés D'ythaqLes Naufragés D'ythaq

위에서 설명한 대로 ToTitleCase 메서드 반드시 언어학적으로 올바른 없는 임의의 대/소문자 구분 동작을 제공 합니다.As illustrated above, the ToTitleCase method provides an arbitrary casing behavior which is not necessarily linguistically correct. 언어학적으로 올바른 솔루션이 추가 규칙이 필요 하 고 현재 알고리즘은 다소 간단 하 고 빠르게입니다.A linguistically correct solution would require additional rules, and the current algorithm is somewhat simpler and faster. 에서는 느린이 API를 나중에 바꿀 수 있는 권한을 보유 합니다.We reserve the right to make this API slower in the future.

현재 구현 된 ToTitleCase 메서드는 입력 문자열과 동일한 길이 출력 문자열을 생성 합니다.The current implementation of the ToTitleCase method yields an output string that is the same length as the input string. 그러나이 동작은 보장 되지 않으며 향후 구현에서 변경 될 수 있습니다.However, this behavior is not guaranteed and could change in a future implementation.

적용 대상

추가 정보