Object.ReferenceEquals(Object, Object) Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt fest, ob die angegebenen Object-Instanzen dieselbe Instanz sind.

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

public static bool ReferenceEquals (object objA, 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

Parameter

objA: Object

Das erste zu vergleichende Objekt.

objB: Object

Das zweite zu vergleichende Objekt.

Gibt zurück

Boolean

true, wenn objA dieselbe Instanz wie objB ist oder beide NULL sind, andernfalls false.

Beispiele

Im folgenden Beispiel wird ReferenceEquals ermittelt, ob zwei Objekte dieselbe Instanz sind.

using namespace System;
int main()
{
   Object^ o = nullptr;
   Object^ p = nullptr;
   Object^ q = gcnew 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

*/

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
'

Hinweise

Im Gegensatz zu der Equals Methode und dem Gleichheitsoperator kann die ReferenceEquals Methode nicht außer Kraft gesetzt werden. Aus diesem Grund können Sie die Methode aufrufen, wenn Sie zwei Objektbezüge für Gleichheit testen möchten und sich nicht über die ReferenceEquals Implementierung der Equals Methode vergewissern.

Der Rückgabewert der ReferenceEquals Methode kann jedoch in diesen beiden Szenarien zu einer Anomalie führen:

Beim Vergleichen von Werttypen. objB Wenn objA sie Werttypen sind, werden sie boxt, bevor sie an die ReferenceEquals Methode übergeben werden. Dies bedeutet, dass objA objB sowohl als auch die gleiche Instanz eines Werttyps dargestellt wird, die Methode trotzdem falsezurückgibt, ReferenceEquals wie im folgenden Beispiel dargestellt.

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

Informationen zu Boxing-Werttypen finden Sie unter Boxing und Unboxing.

Beim Vergleichen von Zeichenfolgen. Wenn objA Zeichenfolgen und objB Zeichenfolgen sind, gibt die Methode zurücktrue, wenn die ReferenceEquals Zeichenfolge interniert ist. Es führt keinen Test für die Wertgleichheit aus. Im folgenden Beispiel sind sie gleich, s1 s2 da sie zwei Instanzen einer einzelnen internen Zeichenfolge sind. s3 s4 Sie sind jedoch nicht gleich, da sie zwar identische Zeichenfolgenwerte haben, diese Zeichenfolge jedoch nicht interniert ist.

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

Weitere Informationen zum Internieren von Zeichenfolgen finden Sie unter String.IsInterned.

Gilt für

Siehe auch

Equals(Object)

Freigeben über