Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.

Tradução

Inglês

Esta documentação foi arquivada e não está sendo atualizada.

Versão recomendada

Método Object.Equals (Object, Object)

Visual Studio 2008

Outras versões

Determina se o especificado Object instâncias são consideradas iguais.

Namespace: System
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

C++

JScript

public static bool Equals(
	Object objA,
	Object objB
)

Parâmetros

objA: Tipo: System.Object
O primeiro Object para comparar.

objB: Tipo: System.Object
O segundo Object para comparar.

Valor de retorno

Tipo: System.Boolean

Comentários

A implementação padrão de Equals oferece suporte à referência igualdade para tipos de referência e igualdade bit a bit para tipos de valor. Igualdade referência significa que as referências de objeto que são comparadas referir-se ao mesmo objeto.Bit a bit igualdade significa os objetos que são comparados têm o mesmo binário representação.

Observe que um tipo derivado pode substituir o Equals método para implementar a igualdade do valor. Valor igualdade significa os objetos em comparação com o mesmo valor mas diferentes representações binárias.

Para obter mais informações, consulte o tópico Object.Equals(Object).

Exemplos

O exemplo de código a seguir compara objetos diferentes.

C++

using System;

publicclass MyClass {
   publicstaticvoid Main() {
   string s1 = "Tom";
   string s2 = "Carol";
   Console.WriteLine("Object.Equals(\"{0}\", \"{1}\") => {2}", 
      s1, s2, Object.Equals(s1, s2));

   s1 = "Tom";
   s2 = "Tom";
   Console.WriteLine("Object.Equals(\"{0}\", \"{1}\") => {2}", 
      s1, s2, Object.Equals(s1, s2));

   s1 = null;
   s2 = "Tom";
   Console.WriteLine("Object.Equals(null, \"{1}\") => {2}",
       s1, s2, Object.Equals(s1, s2));

   s1 = "Carol";
   s2 = null;
   Console.WriteLine("Object.Equals(\"{0}\", null) => {2}", 
       s1, s2, Object.Equals(s1, s2));

   s1 = null;
   s2 = null;
   Console.WriteLine("Object.Equals(null, null) => {2}", 
       s1, s2, Object.Equals(s1, s2));
   }
}


/*

This code produces the following output.

Object.Equals("Tom", "Carol") => False
Object.Equals("Tom", "Tom") => True
Object.Equals(null, "Tom") => False
Object.Equals("Carol", null) => False
Object.Equals(null, null) => True

*/

import System.*;

public class MyClass
{
    public static void main(String[] args)
    {
        String s1 = "Tom";
        String s2 = "Carol";
        Console.WriteLine("Object.Equals(\"{0}\", \"{1}\") => {2}", s1, s2, 
            System.Convert.ToString(Object.Equals(s1, s2)));

        s1 = "Tom";
        s2 = "Tom";
        Console.WriteLine("Object.Equals(\"{0}\", \"{1}\") => {2}", s1, s2, 
            System.Convert.ToString(Object.Equals(s1, s2)));

        s1 = null;
        s2 = "Tom";
        Console.WriteLine("Object.Equals(null, \"{1}\") => {2}", s1, s2, 
            System.Convert.ToString(Object.Equals(s1, s2)));

        s1 = "Carol";
        s2 = null;
        Console.WriteLine("Object.Equals(\"{0}\", null) => {2}", s1, s2, 
            System.Convert.ToString(Object.Equals(s1, s2)));

        s1 = null;
        s2 = null;
        Console.WriteLine("Object.Equals(null, null) => {2}", s1, s2, 
            System.Convert.ToString(Object.Equals(s1, s2)));
    } //main
} //MyClass


/*

This code produces the following output.

Object.Equals("Tom", "Carol") => False
Object.Equals("Tom", "Tom") => True
Object.Equals(null, "Tom") => False
Object.Equals("Carol", null) => False
Object.Equals(null, null) => True

*/

JScript

import System

package Equals0
{    

public class MyClass {
   public static function Main() {
   var s1 : String = "Tom";
   var s2 : String = "Carol";
   var array : Object [] = new Object[3];

   array[0] = s1;
   array[1] = s2;
   array[2] = System.Object.Equals(s1, s2);

   Console.WriteLine("Object.Equals('{0}', '{1}') => {2}", 
      array);

   s1 = "Tom";
   s2 = "Tom";
   array[0] = s1;
   array[1] = s2;
   array[2] = System.Object.Equals(s1, s2);

   Console.WriteLine("Object.Equals('{0}', '{1}') => {2}", 
      array);

   s1 = null;
   s2 = "Tom";
   array[0] = s1;
   array[1] = s2;
   array[2] = System.Object.Equals(s1, s2);

   Console.WriteLine("Object.Equals(null, '{1}') => {2}",
       array);

   s1 = "Carol";
   s2 = null;
   array[0] = s1;
   array[1] = s2;
   array[2] = System.Object.Equals(s1, s2);

   Console.WriteLine("Object.Equals('{0}', null) => {2}", 
       array);

   s1 = null;
   s2 = null;
   array[0] = s1;
   array[1] = s2;
   array[2] = System.Object.Equals(s1, s2);
   Console.WriteLine("Object.Equals(null, null) => {2}", 
       array);
   }   
}

}

Equals0.MyClass.Main();


/*

This code produces the following output.

Object.Equals("Tom", "Carol") => False
Object.Equals("Tom", "Tom") => True
Object.Equals(null, "Tom") => False
Object.Equals("Carol", null) => False
Object.Equals(null, null) => True

*/

Plataformas

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.