String.ToUpperInvariant メソッド

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

String.ToUpperInvariant メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

インバリアント カルチャの大文字と小文字の規則を使用して、この String オブジェクトのコピーを大文字に変換して返します。

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

Visual Basic (宣言)

Public Function ToUpperInvariant As
 String

Visual Basic (使用法)

Dim instance As String
Dim returnValue As String

returnValue = instance.ToUpperInvariant

C#

public string ToUpperInvariant ()

C++

public:
String^ ToUpperInvariant ()

J#

public String ToUpperInvariant ()

JScript

public function ToUpperInvariant () : String

戻り値
大文字の String オブジェクト。

解説

現在のカルチャに依存しない予測可能な形で文字列の大文字と小文字が変化することを前提としたアプリケーションでは、ToUpperInvariant メソッドを使用します。ToUpperInvariant メソッドは ToUpper(CultureInfo.InvariantCulture) と等価です。

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

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

使用例

次のコード例では、小文字だけで構成される文字列を、英語 - 米国カルチャとトルコ語-トルコ カルチャを使用して、大文字から成る 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
'

C#

// 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
*/

J#

// 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
.NET Compact Framework
サポート対象 : 2.0

参照

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