UInt64.Equals メソッド

定義

対象のインスタンスが、指定したオブジェクトまたは UInt64 に等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified object or UInt64.

オーバーロード

Equals(Object)

このインスタンスが指定されたオブジェクトに等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified object.

Equals(UInt64)

このインスタンスが指定した UInt64 値に等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified UInt64 value.

Equals(Object)

このインスタンスが指定されたオブジェクトに等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified object.

public:
 override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean

パラメーター

obj
Object

このインスタンスと比較するオブジェクト。An object to compare to this instance.

戻り値

objUInt64 のインスタンスで、このインスタンスの値に等しい場合は true。それ以外の場合は falsetrue if obj is an instance of UInt64 and equals the value of this instance; otherwise, false.

Equalsメソッドの例を次に示します。The following example demonstrates the Equals method.

using System;

public class Example
{
   public static void Main()
   {
      object[] values = { (short) 10, (short) 20, 10, 20,
                          10L, 20L, 10D, 20D, (ushort) 10,
                          (ushort) 20, 10U, 20U,
                          10ul, 20ul };
      UInt64 baseValue = 20;
      String baseType = baseValue.GetType().Name;
      
      foreach (var value in values)
         Console.WriteLine("{0} ({1}) = {2} ({3}): {4}",
                           baseValue, baseType,
                           value, value.GetType().Name,
                           baseValue.Equals(value));

   }
}
// The example displays the following output:
//       20 (UInt64) = 10 (Int16): False
//       20 (UInt64) = 20 (Int16): False
//       20 (UInt64) = 10 (Int32): False
//       20 (UInt64) = 20 (Int32): False
//       20 (UInt64) = 10 (Int64): False
//       20 (UInt64) = 20 (Int64): False
//       20 (UInt64) = 10 (Double): False
//       20 (UInt64) = 20 (Double): False
//       20 (UInt64) = 10 (UInt16): False
//       20 (UInt64) = 20 (UInt16): False
//       20 (UInt64) = 10 (UInt32): False
//       20 (UInt64) = 20 (UInt32): False
//       20 (UInt64) = 10 (UInt64): False
//       20 (UInt64) = 20 (UInt64): True
Module Example
   Public Sub Main()
      Dim values() As Object = { 10S, 20S, 10I, 20I, 10L, 20L,
                                 10R, 20R, 10US, 20US, 10UI, 20UI,
                                 10UL, 20UL }
      Dim baseValue As UInt64 = 20
      Dim baseType As String = baseValue.GetType().Name
      
      For Each value In values
         Console.WriteLine("{0} ({1}) = {2} ({3}): {4}",
                           baseValue, baseType,
                           value, value.GetType().Name,
                           baseValue.Equals(value))
      Next
   End Sub
End Module
' The example displays the following output:
'       20 (UInt64) = 10 (Int16): False
'       20 (UInt64) = 20 (Int16): False
'       20 (UInt64) = 10 (Int32): False
'       20 (UInt64) = 20 (Int32): False
'       20 (UInt64) = 10 (Int64): False
'       20 (UInt64) = 20 (Int64): False
'       20 (UInt64) = 10 (Double): False
'       20 (UInt64) = 20 (Double): False
'       20 (UInt64) = 10 (UInt16): False
'       20 (UInt64) = 20 (UInt16): False
'       20 (UInt64) = 10 (UInt32): False
'       20 (UInt64) = 20 (UInt32): False
'       20 (UInt64) = 10 (UInt64): False
'       20 (UInt64) = 20 (UInt64): True

注意 (呼び出し元)

コンパイラのオーバーロードの解決では、2つの Equals(UInt64) メソッドオーバーロードの動作の明らかな違いが考慮されます。Compiler overload resolution may account for an apparent difference in the behavior of the two Equals(UInt64) method overloads. obj 引数と UInt64 の間の暗黙的な変換が定義されていて、引数が Objectとして型指定されていない場合、コンパイラは暗黙的な変換を実行し、Equals(UInt64) メソッドを呼び出します。If an implicit conversion between the obj argument and a UInt64 is defined and the argument is not typed as an Object, compilers perform an implicit conversion and call the Equals(UInt64) method. それ以外の場合は、Equals(Object) メソッドを呼び出します。このメソッドは、obj 引数が UInt64 値でない場合は常に false を返します。Otherwise, they call the Equals(Object) method, which always returns false if its obj argument is not a UInt64 value. 次の例は、2つのメソッドオーバーロード間の動作の違いを示しています。The following example illustrates the difference in behavior between the two method overloads. ByteUInt16、および UInt32 値の場合、最初の比較では true が返されます。これは、コンパイラが自動的に拡大変換を実行して Equals(UInt64) メソッドを呼び出し、2番目の比較では false が返されます。コンパイラは Equals(Object) メソッドを呼び出します。In the case of the Byte, UInt16, and UInt32 values, the first comparison returns true because the compiler automatically performs a widening conversion and calls the Equals(UInt64) method, whereas the second comparison returns false because the compiler calls the Equals(Object) method.

[!code-csharpSystem.UInt64.Equals#2] [!code-vbSystem.UInt64.Equals#2][!code-csharpSystem.UInt64.Equals#2] [!code-vbSystem.UInt64.Equals#2]

こちらもご覧ください

Equals(UInt64)

このインスタンスが指定した UInt64 値に等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified UInt64 value.

public:
 virtual bool Equals(System::UInt64 obj);
public bool Equals (ulong obj);
override this.Equals : uint64 -> bool
Public Function Equals (obj As ULong) As Boolean

パラメーター

obj
UInt64

このインスタンスと比較する UInt64 値。A UInt64 value to compare to this instance.

戻り値

obj の値がこのインスタンスと同じ場合は true。それ以外の場合は falsetrue if obj has the same value as this instance; otherwise, false.

実装

Equalsメソッドの例を次に示します。The following example demonstrates the Equals method.

using namespace System;

int main()
{
      UInt64 value1 = 50;
      UInt64 value2 = 50;

      // Display the values.
        Console::WriteLine("value1:   Type: {0}   Value: {1}",
                           value1.GetType()->Name, value1);
        Console::WriteLine("value2:   Type: {0}   Value: {1}",
                         value2.GetType()->Name, value2);

        // Compare the two values.
        Console::WriteLine("value1 and value2 are equal: {0}",
                           value1.Equals(value2));
}
// The example displays the following output:
//       value1:   Type: UInt64   Value: 50
//       value2:   Type: UInt64   Value: 50
//       value1 and value2 are equal: True
using System;

class Example
{
     public static void Main()
     {
         UInt64 value1 = 50;
         UInt64 value2 = 50;

         // Display the values.
        Console.WriteLine("value1:   Type: {0}   Value: {1}",
                          value1.GetType().Name, value1);
        Console.WriteLine("value2:   Type: {0}   Value: {1}",
                        value2.GetType().Name, value2);

        // Compare the two values.
        Console.WriteLine("value1 and value2 are equal: {0}",
                          value1.Equals(value2));
     }
}
// The example displays the following output:
//       value1:   Type: UInt64   Value: 50
//       value2:   Type: UInt64   Value: 50
//       value1 and value2 are equal: True
Class Example
   Public Shared Sub Main()
      Dim value1 As UInt64 = 50
      Dim value2 As UInt64 = 50
      
      'Display the values.
      Console.WriteLine("value1:   Type: {0}   Value: {1}",
                        value1.GetType().Name, value1)
      Console.WriteLine("value2:   Type: {0}   Value: {1}",
                        value2.GetType().Name, value2)

      ' Compare the two values.
      Console.WriteLine("value1 and value2 are equal: {0}",
                        value1.Equals(value2))
   End Sub
End Class 
' The example displays the following output:
'       value1:   Type: UInt64   Value: 50
'       value2:   Type: UInt64   Value: 50
'       value1 and value2 are equal: True

注釈

このメソッドは System.IEquatable<T> インターフェイスを実装し、obj パラメーターをオブジェクトに変換する必要がないため、Equals よりもわずかにパフォーマンスが向上します。This method implements the System.IEquatable<T> interface, and performs slightly better than Equals because it does not have to convert the obj parameter to an object.

注意 (呼び出し元)

コンパイラのオーバーロードの解決では、2つの Equals(UInt64) メソッドオーバーロードの動作の明らかな違いが考慮されます。Compiler overload resolution may account for an apparent difference in the behavior of the two Equals(UInt64) method overloads. obj 引数と UInt64 の間の暗黙的な変換が定義されていて、引数が Objectとして型指定されていない場合、コンパイラは暗黙的な変換を実行し、Equals(UInt64) メソッドを呼び出します。If an implicit conversion between the obj argument and a UInt64 is defined and the argument is not typed as an Object, compilers perform an implicit conversion and call the Equals(UInt64) method. それ以外の場合は、Equals(Object) メソッドを呼び出します。このメソッドは、obj 引数が UInt64 値でない場合は常に false を返します。Otherwise, they call the Equals(Object) method, which always returns false if its obj argument is not a UInt64 value. 次の例は、2つのメソッドオーバーロード間の動作の違いを示しています。The following example illustrates the difference in behavior between the two method overloads. ByteUInt16、および UInt32 値の場合、最初の比較では true が返されます。これは、コンパイラが自動的に拡大変換を実行して Equals(UInt64) メソッドを呼び出し、2番目の比較では false が返されます。コンパイラは Equals(Object) メソッドを呼び出します。In the case of the Byte, UInt16, and UInt32 values, the first comparison returns true because the compiler automatically performs a widening conversion and calls the Equals(UInt64) method, whereas the second comparison returns false because the compiler calls the Equals(Object) method.

[!code-csharpSystem.UInt64.Equals#2] [!code-vbSystem.UInt64.Equals#2][!code-csharpSystem.UInt64.Equals#2] [!code-vbSystem.UInt64.Equals#2]

適用対象