String.CompareTo メソッド (Object)

このインスタンスと、指定した Object を比較します。

Overloads Public Overridable Function CompareTo( _
   ByVal value As Object _) As Integer Implements IComparable.CompareTo
[C#]
public virtual int CompareTo(objectvalue);
[C++]
public: virtual int CompareTo(Object* value);
[JScript]
public function CompareTo(
   value : Object) : int;

パラメータ

• value
  String と評価される Object 。

戻り値

2 つの比較対照値の構文上の関係を示す 32 ビット符号付き整数。

実装

IComparable.CompareTo

例外

解説

value は String オブジェクトである必要があります。

このメソッドは、現在のカルチャを使用して、単語 (大文字/小文字を区別し、カルチャに依存した) 比較を実行します。単語、文字列、序数の並べ替えの詳細については、「 System.Globalization.CompareOptions 」を参照してください。

このメソッドの動作の詳細については、 Compare メソッドの解説を参照してください。

使用例

CompareTo メソッドを Object と共に使用する方法については、次のコード例を参照してください。

 
Imports System

Public Class [MyClass]
End Class '[MyClass]

Public Class ArgExceptionExample
   
   Public Shared Sub Main()
      Dim my As New [MyClass]()
      Dim s As String = "sometext"
      Try
         Dim i As Integer = s.CompareTo(my)
      Catch e As Exception
         Console.WriteLine("Error: {0}", e.ToString())
      End Try
   End Sub 'Main
End Class 'ArgExceptionExample

[C#] 
using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static void Main()
      {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
         {
         int i = s.CompareTo(my);
         }
            catch (Exception e) 
            {
            Console.WriteLine("Error: {0}",e.ToString());
            }
      }
}

[C++] 
#using <mscorlib.dll>

using namespace System;

public __gc class MyClass {};

int main() {
   MyClass* my = new MyClass();
   String* s = S"sometext";
   try {
      int i = s->CompareTo(my);
   } catch (Exception* e) {
      Console::WriteLine(S"Error: {0}", e->ToString());
   }
}

[JScript] 
import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

String クラス | String メンバ | System 名前空間 | String.CompareTo オーバーロードの一覧 | Compare | CompareOrdinal