String.ToUpper メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

String.ToUpper メソッド (CultureInfo)

指定されたカルチャの大文字と小文字の規則を使用して、この String のコピーを大文字に変換して返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function ToUpper ( _
    culture As CultureInfo _
) As String

Visual Basic (使用法)

Dim instance As String
Dim culture As CultureInfo
Dim returnValue As String

returnValue = instance.ToUpper(culture)

public string ToUpper (
    CultureInfo culture
)

C++

public:
String^ ToUpper (
    CultureInfo^ culture
)

public String ToUpper (
    CultureInfo culture
)

JScript

public function ToUpper (
    culture : CultureInfo
) : String

パラメータ

culture: カルチャ固有の大文字と小文字の規則を提供する CultureInfo。

戻り値
大文字の String。

例外

例外の種類	条件
ArgumentNullException	culture が null 参照 (Visual Basic では Nothing) です。

解説

現在有効なカルチャの大文字と小文字の規則によって、文字列の大文字と小文字を変更する方法が決まります。文字列の大文字と小文字が予測できる形で変更されることを前提としたアプリケーションでは、有効なカルチャが突然変更されると、無効な結果が得られる可能性があります。次の検索ルーチンを考えます。検索キーにはテキストの文字列を使用します。比較を簡単にするため、キーは強制的に標準的な大文字/小文字の形式とします。有効なカルチャは、現在のスレッドに対応するカルチャです。

static object LookupKey(string key) { return internalHashtable[key.ToUpper()]; }

現在のスレッドや対応するカルチャが突然変わる可能性がある場合は、既定での現在のスレッドのカルチャではなく、インバリアントカルチャを指定することをお勧めします。推奨する方法を次の例に示します。

static object LookupKey(string key) { return internalHashtable[key.ToUpper(CultureInfo.InvariantCulture)];
 }

使用例

次のコード例では、小文字だけで構成される文字列を、英語 - 米国カルチャとトルコ語-トルコカルチャを使用して、大文字から成る 2 つの文字列に変換し、変換後の 2 つの文字列を比較しています。この 2 つの文字列は、一方が Unicode LATIN の大文字 I を使用しているのに対し、もう一方は LATIN の大文字 I (上にドットが付く) を使用している以外は同じです。

Visual Basic

' Sample for String.ToUpper(CultureInfo)
Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic

Class Sample
   
   Public Shared Sub Main()
      Dim str1 As [String] = "indigo"
      Dim str2, str3 As [String]
      
      Console.WriteLine()
      Console.WriteLine("str1 = '{0}'", str1)

      Console.WriteLine("str2 = Upper case copy of str1 using
 English-United States culture.")
      ' str2 is an upper case copy of str1, using English-United States
 culture.
      str2 = str1.ToUpper(New CultureInfo("en-US",
 False))
      
      ' str3 is an upper case copy of str1, using Turkish-Turkey culture.
      Console.WriteLine("str3 = Upper case copy of str1 using
 Turkish-Turkey culture.")
      str3 = str1.ToUpper(New CultureInfo("tr-TR",
 False))
      
      ' Compare the code points in str2 and str3.
      Console.WriteLine()
      Console.WriteLine("str2 is {0} to str3.", IIf(0
 = [String].CompareOrdinal(str2, str3), "equal",
 "not equal"))
      CodePoints("str1", str1)
      CodePoints("str2", str2)
      CodePoints("str3", str3)
   End Sub 'Main
   
   Public Shared Sub CodePoints(title
 As [String], s As [String])
      Console.Write("{0}The code points in {1} are: {0}",
 Environment.NewLine, title)
      Dim c As Char
      For Each c In  s
         Console.Write("{0:x4} ", AscW(c))
      Next c
      Console.WriteLine()
   End Sub 'CodePoints
End Class 'Sample
'
'This example produces the following results:
'
'str1 = 'indigo'
'str2 = Upper case copy of str1 using English-United States culture.
'str3 = Upper case copy of str1 using Turkish-Turkey culture.
'
'str2 is not equal to str3.
'
'The code points in str1 are:
'0069 006e 0064 0069 0067 006f
'
'The code points in str2 are:
'0049 004e 0044 0049 0047 004f
'
'The code points in str3 are:
'0130 004e 0044 0130 0047 004f
'

// Sample for String.ToUpper(CultureInfo)
using System;
using System.Globalization;

class Sample 
{
    public static void Main()
 
    {
    String str1 = "indigo";
    String str2, str3;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}'", str1);

    Console.WriteLine("str2 = Upper case copy of str1 using
 English-United States culture.");
    // str2 is an upper case copy of str1, using English-United States
 culture.
    str2 = str1.ToUpper(new CultureInfo("en-US", false));

    // str3 is an upper case copy of str1, using Turkish-Turkey culture.
    Console.WriteLine("str3 = Upper case copy of str1 using
 Turkish-Turkey culture.");
    str3 = str1.ToUpper(new CultureInfo("tr-TR", false));

    // Compare the code points in str2 and str3.
    Console.WriteLine();
    Console.WriteLine("str2 is {0} to str3.", 
         ((0 == String.CompareOrdinal(str2, str3)) ? "equal" : "not
 equal"));
    CodePoints("str1", str1);
    CodePoints("str2", str2);
    CodePoints("str3", str3);
    }

    public static void CodePoints(String
 title, String s)
    {
    Console.Write("{0}The code points in {1} are: {0}",
 Environment.NewLine, title);
    foreach (ushort u in s)
      Console.Write("{0:x4} ", u);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United
 States culture.
str3 = Upper case copy of str1 using Turkish-Turkey
 culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

C++

// Sample for String::ToUpper(CultureInfo)
using namespace System;
using namespace System::Globalization;
void CodePoints( String^ title, String^ s )
{
   Console::Write( " {0}The code points in {1} are: {0}",
 Environment::NewLine, title );
   System::Collections::IEnumerator^ myEnum = s->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      UInt16 u = safe_cast<Char>(myEnum->Current);
      Console::Write( "{0:x4} ", u );
   }

   Console::WriteLine();
}

int main()
{
   String^ str1 = "indigo";
   String^ str2;
   String^ str3;
   Console::WriteLine();
   Console::WriteLine( "str1 = ' {0}'", str1 );
   Console::WriteLine( "str2 = Upper case copy of str1 using English-United
 States culture." );
   
   // str2 is an upper case copy of str1, using English-United States
 culture.
   str2 = str1->ToUpper( gcnew CultureInfo( "en-US",false
 ) );
   
   // str3 is an upper case copy of str1, using Turkish-Turkey culture.
   Console::WriteLine( "str3 = Upper case copy of str1 using Turkish-Turkey
 culture." );
   str3 = str1->ToUpper( gcnew CultureInfo( "tr-TR",false
 ) );
   
   // Compare the code points in str2 and str3.
   Console::WriteLine();
   Console::WriteLine( "str2 is {0} to str3.", ((0 == String::CompareOrdinal(
 str2, str3 )) ? (String^)"equal" : "not equal") );
   CodePoints( "str1", str1 );
   CodePoints( "str2", str2 );
   CodePoints( "str3", str3 );
}

/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United
 States culture.
str3 = Upper case copy of str1 using Turkish-Turkey
 culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

// Sample for String.ToUpper(CultureInfo)
import System.*;
import System.Globalization.*;

class Sample
{
    public static void main(String[]
 args)
    {
        String str1 = "indigo";
        String str2, str3;

        Console.WriteLine();
        Console.WriteLine("str1 = '{0}'", str1);

        Console.WriteLine("str2 = Upper case copy of str1
 using English-"
            + "United States culture.");

        // str2 is an upper case copy of str1, using English-United
 States 
        // culture.
        str2 = str1.ToUpper(new CultureInfo("en-US",
 false));

        // str3 is an upper case copy of str1, using Turkish-Turkey
 culture.
        Console.WriteLine("str3 = Upper case copy of str1
 using Turkish-"
            + "Turkey culture.");
        str3 = str1.ToUpper(new CultureInfo("tr-TR",
 false));

        // Compare the code points in str2 and str3.
        Console.WriteLine();
        Console.WriteLine("str2 is {0} to str3.", 
            (0 == String.CompareOrdinal(str2, str3)) ? "equal" : "not
 equal");
        CodePoints("str1", str1);
        CodePoints("str2", str2);
        CodePoints("str3", str3);
    } //main

    public static void CodePoints(String
 title, String s)
    {
        Console.Write("{0}The code points in {1} are: {0}",
 
            Environment.get_NewLine(), title);
        for (int iCtr = 0; iCtr < s.get_Length();
 iCtr++) {
            UInt16 u = (UInt16)s.charAt(iCtr);
            Console.Write("{0:x4} ", u);
        }
        Console.WriteLine();
    } //CodePoints
} //Sample
/*
This example produces the following results:

str1 = 'indigo'
str2 = Upper case copy of str1 using English-United
 States culture.
str3 = Upper case copy of str1 using Turkish-Turkey
 culture.

str2 is not equal to str3.

The code points in str1 are:
0069 006e 0064 0069 0067 006f

The code points in str2 are:
0049 004e 0044 0049 0047 004f

The code points in str3 are:
0130 004e 0044 0130 0047 004f
*/

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
ToLower

String.ToUpper メソッド

String のコピーを大文字に変換して返します。
オーバーロードの一覧

名前	説明
String.ToUpper ()	現在のカルチャの大文字と小文字の規則を使用して、この String のコピーを大文字に変換して返します。 .NET Compact Framework によってサポートされています。
String.ToUpper (CultureInfo)	指定されたカルチャの大文字と小文字の規則を使用して、この String のコピーを大文字に変換して返します。 .NET Compact Framework によってサポートされています。

参照

String.ToUpper メソッド ()

現在のカルチャの大文字と小文字の規則を使用して、この String のコピーを大文字に変換して返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function ToUpper As
 String

Visual Basic (使用法)

Dim instance As String
Dim returnValue As String

returnValue = instance.ToUpper

public string ToUpper ()

C++

public:
String^ ToUpper ()

public String ToUpper ()

JScript

public function ToUpper () : String

戻り値
大文字の String。

解説

このメソッドでは、現在のカルチャが考慮されます。詳細については、CultureInfo のトピックを参照してください。

セキュリティについての考慮事項

ファイル名、名前付きパイプ、レジストリキーなど、オペレーティングシステム識別子の小文字形式または大文字形式が必要な場合は、ToLowerInvariant メソッドまたは ToUpperInvariant メソッドを使用します。

使用例

ToUpper メソッドを使用し、大文字と小文字を区別せずに String を比較するコード例を次に示します。

unsafe
{
    // Null terminated ASCII characters in an sbyte array
    String szAsciiUpper = null;
    sbyte[] sbArr1 = new sbyte[] { 0x41, 0x42, 0x43, 0x00 };
    // Instruct the Garbage Collector not to move the memory
    fixed(sbyte* pAsciiUpper = sbArr1)
    {
        szAsciiUpper = new String(pAsciiUpper);
    }
    String szAsciiLower = null;
    sbyte[] sbArr2 = { 0x61, 0x62, 0x63, 0x00 };
    // Instruct the Garbage Collector not to move the memory
    fixed(sbyte* pAsciiLower = sbArr2)
    {
        szAsciiLower = new String(pAsciiLower, 0, sbArr2.Length);
    }
    // Prints "ABC abc"
    Console.WriteLine(szAsciiUpper + " " + szAsciiLower);

    // Compare Strings - the result is true
    Console.WriteLine("The Strings are equal when capitalized ? " +
        (String.Compare(szAsciiUpper.ToUpper(), szAsciiLower.ToUpper())==0?"true":"false")
 );

    // This is the effective equivalent of another Compare method, which
 ignores case
    Console.WriteLine("The Strings are equal when capitalized ? " +
        (String.Compare(szAsciiUpper, szAsciiLower, true)==0?"true":"false")
 );
}

C++

// Null terminated ASCII characters in a simple char array
char charArray3[4] = {0x41,0x42,0x43,0x00};
char * pstr3 =  &charArray3[ 0 ];
String^ szAsciiUpper = gcnew String( pstr3 );
char charArray4[4] = {0x61,0x62,0x63,0x00};
char * pstr4 =  &charArray4[ 0 ];
String^ szAsciiLower = gcnew String( pstr4,0,sizeof(charArray4) );

// Prints "ABC abc"
Console::WriteLine( String::Concat( szAsciiUpper,  " ", szAsciiLower )
 );

// Compare Strings - the result is true
Console::WriteLine( String::Concat(  "The Strings are equal when capitalized
 ? ", (0 == String::Compare( szAsciiUpper->ToUpper(), szAsciiLower->ToUpper()
 ) ? (String^)"TRUE" :  "FALSE") ) );

// This is the effective equivalent of another Compare method, which
 ignores case
Console::WriteLine( String::Concat(  "The Strings are equal when capitalized
 ? ", (0 == String::Compare( szAsciiUpper, szAsciiLower, true
 ) ? (String^)"TRUE" :  "FALSE") ) );