Object.ReferenceEquals(Object, Object) メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Runtime.dll

ソース:

Object.cs

指定した Object インスタンスが同じインスタンスであるかどうかを判断します。

public:
 static bool ReferenceEquals(System::Object ^ objA, System::Object ^ objB);

public static bool ReferenceEquals(object? objA, object? objB);

static member ReferenceEquals : obj * obj -> bool

Public Shared Function ReferenceEquals (objA As Object, objB As Object) As Boolean

パラメーター

objA

Object

比較する最初のオブジェクト。

objB

Object

比較する 2 番目のオブジェクト。

返品

Boolean

true objAがobjBと同じインスタンスである場合、または両方が null の場合はfalse。

例

次の例では、 ReferenceEquals を使用して、2 つのオブジェクトが同じインスタンスであるかどうかを判断します。

object o = null;
object p = null;
object q = new Object();

Console.WriteLine(Object.ReferenceEquals(o, p));
p = q;
Console.WriteLine(Object.ReferenceEquals(p, q));
Console.WriteLine(Object.ReferenceEquals(o, p));

// This code produces the following output:
//   True
//   True
//   False

let o: obj = null
let mutable p: obj = null
let q = obj ()

printfn $"{Object.ReferenceEquals(o, p)}"
p <- q
printfn $"{Object.ReferenceEquals(p, q)}"
printfn $"{Object.ReferenceEquals(o, p)}"

// This code produces the following output:
//   True
//   True
//   False

Public Class App
    Public Shared Sub Main() 
        Dim o As Object = Nothing
        Dim p As Object = Nothing
        Dim q As New Object
        Console.WriteLine(Object.ReferenceEquals(o, p))
        p = q
        Console.WriteLine(Object.ReferenceEquals(p, q))
        Console.WriteLine(Object.ReferenceEquals(o, p))
    End Sub 
End Class 
' This code produces the following output:
'
' True
' True
' False
'

注釈

Equals メソッドと等値演算子とは異なり、ReferenceEquals メソッドをオーバーライドすることはできません。 このため、2 つのオブジェクト参照の等価性をテストする必要があり、 Equals メソッドの実装がわからない場合は、 ReferenceEquals メソッドを呼び出すことができます。

ただし、 ReferenceEquals メソッドの戻り値は、次の 2 つのシナリオでは異常に見える場合があります。

• 値型を比較する場合。 objAとobjBが値型の場合、ReferenceEquals メソッドに渡される前にボックス化されます。 つまり、 objA と objB の両方が値型の同じインスタンスを表している場合、次の例に示すように、 ReferenceEquals メソッドは falseを返します。

  int int1 = 3;
  Console.WriteLine(Object.ReferenceEquals(int1, int1));
  Console.WriteLine(int1.GetType().IsValueType);
  
  // The example displays the following output:
  //       False
  //       True
  

  let int1 = 3
  printfn $"{Object.ReferenceEquals(int1, int1)}"
  printfn $"{int1.GetType().IsValueType}"
  
  // The example displays the following output:
  //       False
  //       True
  

  Public Module Example
     Public Sub Main
        Dim int1 As Integer = 3
        Console.WriteLine(Object.ReferenceEquals(int1, int1))
        Console.WriteLine(int1.GetType().IsValueType)
     End Sub
  End Module
  ' The example displays the following output:
  '       False
  '       True
  

  ボックス化の値の種類については、「 ボックス化とボックス化解除」を参照してください。

• 文字列を比較する場合。 objAとobjBが文字列の場合、ReferenceEquals メソッドは文字列がインターンされている場合にtrueを返します。 値の等価性のテストは実行されません。 次の例では、1 つのインターン文字列の 2 つのインスタンスであるため、 s1 と s2 は等しくなります。 ただし、 s3 と s4 は同じ文字列値を持ちますが、その文字列はインターンされないため、等しくありません。

  String s1 = "String1";
  String s2 = "String1";
  Console.WriteLine("s1 = s2: {0}", Object.ReferenceEquals(s1, s2));
  Console.WriteLine("{0} interned: {1}", s1,
                    String.IsNullOrEmpty(String.IsInterned(s1)) ? "No" : "Yes");
  
  String suffix = "A";
  String s3 = "String" + suffix;
  String s4 = "String" + suffix;
  Console.WriteLine("s3 = s4: {0}", Object.ReferenceEquals(s3, s4));
  Console.WriteLine("{0} interned: {1}", s3,
                    String.IsNullOrEmpty(String.IsInterned(s3)) ? "No" : "Yes");
  
  // The example displays the following output:
  //       s1 = s2: True
  //       String1 interned: Yes
  //       s3 = s4: False
  //       StringA interned: No
  

  open System
  
  let s1 = "String1"
  let s2 = "String1"
  printfn $"s1 = s2: {Object.ReferenceEquals(s1, s2)}"
  printfn $"""{s1} interned: {if String.IsNullOrEmpty(String.IsInterned s1) then "No" else "Yes"}"""
  
  let suffix = "A"
  let s3 = "String" + suffix
  let s4 = "String" + suffix
  printfn $"s3 = s4: {Object.ReferenceEquals(s3, s4)}"
  printfn $"""{s3} interned: {if String.IsNullOrEmpty(String.IsInterned s3) then "No" else "Yes"}"""
  
  // The example displays the following output:
  //       s1 = s2: True
  //       String1 interned: Yes
  //       s3 = s4: False
  //       StringA interned: No
  

  Module Example
     Public Sub Main()
        Dim s1 As String = "String1"
        Dim s2 As String = "String1"
        Console.WriteLine("s1 = s2: {0}", Object.ReferenceEquals(s1, s2))
        Console.WriteLine("{0} interned: {1}", s1, 
                          If(String.IsNullOrEmpty(String.IsInterned(s1)), "No", "Yes"))
  
        Dim suffix As String = "A"
        Dim s3 = "String" + suffix
        Dim s4 = "String" + suffix
        Console.WriteLine("s3 = s4: {0}", Object.ReferenceEquals(s3, s4))
        Console.WriteLine("{0} interned: {1}", s3, 
                          If(String.IsNullOrEmpty(String.IsInterned(s3)), "No", "Yes"))
     End Sub
  End Module
  ' The example displays the following output:
  '       s1 = s2: True
  '       String1 interned: Yes
  '       s3 = s4: False
  '       StringA interned: No
  

  文字列のインターンの詳細については、 String.IsInternedを参照してください。

こちらもご覧ください

• Equals(Object)