Object Object Object Object Class

Definition

Prend en charge toutes les classes de la hiérarchie des classes du .NET Framework et fournit des services de bas niveau à des classes dérivées. Supports all classes in the .NET Framework class hierarchy and provides low-level services to derived classes. Il s'agit de la classe de base fondamentale parmi toutes les classes du .NET Framework. Elle constitue la racine de la hiérarchie des types. This is the ultimate base class of all classes in the .NET Framework; it is the root of the type hierarchy.

public ref class Object
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDual)]
[System.Runtime.InteropServices.ComVisible(true)]
[Serializable]
public class Object
type obj = class
Public Class Object
Attributes

Examples

L’exemple suivant définit un type Point dérivé le Object classe et substitue un grand nombre de méthodes virtuelles de la Object classe.The following example defines a Point type derived from the Object class and overrides many of the virtual methods of the Object class. En outre, l’exemple montre comment appeler la plupart des statiques et les méthodes de l’instance la Object classe.In addition, the example shows how to call many of the static and instance methods of the Object class.

using namespace System;

// The Point class is derived from System.Object.
ref class Point
{
public:
    int x;
public:
    int y;

public:
    Point(int x, int y)
    {
        this->x = x;
        this->y = y;
    }

public:
    virtual bool Equals(Object^ obj) override
    {
        // If this and obj do not refer to the same type,
        // then they are not equal.
        if (obj->GetType() != this->GetType())
        {
            return false;
        }

        // Return true if  x and y fields match.
        Point^ other = (Point^) obj;
        return (this->x == other->x) && (this->y == other->y);
    }

    // Return the XOR of the x and y fields.
public:
    virtual int GetHashCode() override 
    {
        return x ^ y;
    }

    // Return the point's value as a string.
public:
    virtual String^ ToString() override 
    {
        return String::Format("({0}, {1})", x, y);
    }

    // Return a copy of this point object by making a simple
    // field copy.
public:
    Point^ Copy()
    {
        return (Point^) this->MemberwiseClone();
    }
};

int main()
{
    // Construct a Point object.
    Point^ p1 = gcnew Point(1, 2);

    // Make another Point object that is a copy of the first.
    Point^ p2 = p1->Copy();

    // Make another variable that references the first
    // Point object.
    Point^ p3 = p1;

    // The line below displays false because p1 and 
    // p2 refer to two different objects.
    Console::WriteLine(
        Object::ReferenceEquals(p1, p2));

    // The line below displays true because p1 and p2 refer
    // to two different objects that have the same value.
    Console::WriteLine(Object::Equals(p1, p2));

    // The line below displays true because p1 and 
    // p3 refer to one object.
    Console::WriteLine(Object::ReferenceEquals(p1, p3));

    // The line below displays: p1's value is: (1, 2)
    Console::WriteLine("p1's value is: {0}", p1->ToString());
}

// This code produces the following output.
//
// False
// True
// True
// p1's value is: (1, 2)
using System;

// The Point class is derived from System.Object.
class Point 
{
    public int x, y;

    public Point(int x, int y) 
    {
        this.x = x;
        this.y = y;
    }
    
    public override bool Equals(object obj) 
    {
        // If this and obj do not refer to the same type, then they are not equal.
        if (obj.GetType() != this.GetType()) return false;

        // Return true if  x and y fields match.
        Point other = (Point) obj;
        return (this.x == other.x) && (this.y == other.y);
    }

    // Return the XOR of the x and y fields.
    public override int GetHashCode() 
    {
        return x ^ y;
    }

    // Return the point's value as a string.
    public override String ToString() 
    {
        return String.Format("({0}, {1})", x, y);
    }

    // Return a copy of this point object by making a simple field copy.
    public Point Copy() 
    {
        return (Point) this.MemberwiseClone();
    }
}

public sealed class App {
    static void Main() 
    {
        // Construct a Point object.
        Point p1 = new Point(1,2);

        // Make another Point object that is a copy of the first.
        Point p2 = p1.Copy();

        // Make another variable that references the first Point object.
        Point p3 = p1;

        // The line below displays false because p1 and p2 refer to two different objects.
        Console.WriteLine(Object.ReferenceEquals(p1, p2));

        // The line below displays true because p1 and p2 refer to two different objects that have the same value.
        Console.WriteLine(Object.Equals(p1, p2));
      
        // The line below displays true because p1 and p3 refer to one object.
        Console.WriteLine(Object.ReferenceEquals(p1, p3));
        
        // The line below displays: p1's value is: (1, 2)
        Console.WriteLine("p1's value is: {0}", p1.ToString());
    }
}

// This code example produces the following output:
//
// False
// True
// True
// p1's value is: (1, 2)
//
' The Point class is derived from System.Object.
Class Point
    Public x, y As Integer
    
    Public Sub New(ByVal x As Integer, ByVal y As Integer) 
        Me.x = x
        Me.y = y
    End Sub
    
    Public Overrides Function Equals(ByVal obj As Object) As Boolean 
        ' If Me and obj do not refer to the same type, then they are not equal.
        Dim objType As Type = obj.GetType()
        Dim meType  As Type = Me.GetType()
        If Not objType.Equals(meType) Then
            Return False
        End If 
        ' Return true if  x and y fields match.
        Dim other As Point = CType(obj, Point)
        Return Me.x = other.x AndAlso Me.y = other.y
    End Function 

    ' Return the XOR of the x and y fields.
    Public Overrides Function GetHashCode() As Integer 
        Return (x << 1) XOr y
    End Function 

    ' Return the point's value as a string.
    Public Overrides Function ToString() As String 
        Return String.Format("({0}, {1})", x, y)
    End Function

    ' Return a copy of this point object by making a simple field copy.
    Public Function Copy() As Point 
        Return CType(Me.MemberwiseClone(), Point)
    End Function
End Class  

NotInheritable Public Class App
    Shared Sub Main() 
        ' Construct a Point object.
        Dim p1 As New Point(1, 2)
        
        ' Make another Point object that is a copy of the first.
        Dim p2 As Point = p1.Copy()
        
        ' Make another variable that references the first Point object.
        Dim p3 As Point = p1
        
        ' The line below displays false because p1 and p2 refer to two different objects.
        Console.WriteLine([Object].ReferenceEquals(p1, p2))

        ' The line below displays true because p1 and p2 refer to two different objects 
        ' that have the same value.
        Console.WriteLine([Object].Equals(p1, p2))

        ' The line below displays true because p1 and p3 refer to one object.
        Console.WriteLine([Object].ReferenceEquals(p1, p3))
        
        ' The line below displays: p1's value is: (1, 2)
        Console.WriteLine("p1's value is: {0}", p1.ToString())
    
    End Sub
End Class
' This example produces the following output:
'
' False
' True
' True
' p1's value is: (1, 2)
'

Remarks

Langues ne nécessitent généralement pas une classe déclare l’héritage de Object , car l’héritage est implicite.Languages typically do not require a class to declare inheritance from Object because the inheritance is implicit.

Étant donné que toutes les classes dans le .NET Framework sont dérivées de Object, toutes les méthodes définies dans le Object classe est disponible dans tous les objets dans le système.Because all classes in the .NET Framework are derived from Object, every method defined in the Object class is available in all objects in the system. Classes dérivées peuvent et substituer certaines de ces méthodes, notamment :Derived classes can and do override some of these methods, including:

  • Equals -Prend en charge les comparaisons entre objets.Equals - Supports comparisons between objects.

  • Finalize -Effectue des opérations de nettoyage avant qu’un objet est automatiquement récupéré.Finalize - Performs cleanup operations before an object is automatically reclaimed.

  • GetHashCode -Génère un nombre correspondant à la valeur de l’objet pour prendre en charge l’utilisation d’une table de hachage.GetHashCode - Generates a number corresponding to the value of the object to support the use of a hash table.

  • ToString -Fabrique une chaîne de texte explicite qui décrit une instance de la classe.ToString - Manufactures a human-readable text string that describes an instance of the class.

Considérations sur les performancesPerformance Considerations

Si vous concevez une classe, telle qu’une collection, qui doit gérer tout type d’objet, vous pouvez créer des membres de classe qui acceptent des instances de la Object classe.If you are designing a class, such as a collection, that must handle any type of object, you can create class members that accept instances of the Object class. Toutefois, le processus de boxing et unboxing d’un type a une incidence sur les performances.However, the process of boxing and unboxing a type carries a performance cost. Si vous savez que votre nouvelle classe devra souvent gérer certains types valeur, vous pouvez utiliser une des deux solutions suivantes pour réduire le coût de conversion boxing.If you know your new class will frequently handle certain value types you can use one of two tactics to minimize the cost of boxing.

  • Créer une méthode générale qui accepte un Object type et un ensemble de surcharges de méthode spécifique au type qui acceptent chaque type de valeur que votre classe à gérer souvent.Create a general method that accepts an Object type, and a set of type-specific method overloads that accept each value type you expect your class to frequently handle. Si une méthode spécifique au type existe qui accepte le type de paramètre appelant, aucun boxing se produit et la méthode spécifique au type est appelée.If a type-specific method exists that accepts the calling parameter type, no boxing occurs and the type-specific method is invoked. S’il n’existe aucun argument de méthode qui correspond au type de paramètre appelant, le paramètre est boxed et la méthode générale est appelée.If there is no method argument that matches the calling parameter type, the parameter is boxed and the general method is invoked.

  • Concevez votre type et ses membres pour utiliser des génériques.Design your type and its members to use generics. Le common language runtime crée un type générique fermé lorsque vous créez une instance de votre classe et que vous spécifiez un argument de type générique.The common language runtime creates a closed generic type when you create an instance of your class and specify a generic type argument. La méthode générique est spécifique au type et peut être appelée sans avoir à évaluer le paramètre appelant.The generic method is type-specific and can be invoked without boxing the calling parameter.

Bien qu’il est parfois nécessaire de développer des classes à usage général qui acceptent et retournent Object types, vous pouvez améliorer les performances en fournissant également une classe spécifique au type pour gérer un type fréquemment utilisé.Although it is sometimes necessary to develop general purpose classes that accept and return Object types, you can improve performance by also providing a type-specific class to handle a frequently used type. Par exemple, en fournissant une classe qui est spécifique à la définition et l’obtention des valeurs booléennes élimine le coût de conversion boxing et unboxing des valeurs booléennes.For example, providing a class that is specific to setting and getting Boolean values eliminates the cost of boxing and unboxing Boolean values.

Constructors

Object() Object() Object() Object()

Initialise une nouvelle instance de la classe Object. Initializes a new instance of the Object class.

Methods

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel. Determines whether the specified object is equal to the current object.

Equals(Object, Object) Equals(Object, Object) Equals(Object, Object) Equals(Object, Object)

Détermine si les instances d'objet spécifiées sont considérées comme égales. Determines whether the specified object instances are considered equal.

Finalize() Finalize() Finalize() Finalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut. Serves as the default hash function.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle. Gets the Type of the current instance.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel. Creates a shallow copy of the current Object.

ReferenceEquals(Object, Object) ReferenceEquals(Object, Object) ReferenceEquals(Object, Object) ReferenceEquals(Object, Object)

Détermine si les instances de Object spécifiées sont identiques. Determines whether the specified Object instances are the same instance.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel. Returns a string that represents the current object.

Applies to

Thread Safety

Statique public (Shared en Visual Basic) de ce type sont thread-safe. Public static (Shared in Visual Basic) members of this type are thread safe. Membres d’instance ne sont pas garantis pour être thread-safe. Instance members are not guaranteed to be thread-safe.