Object.MemberwiseClone Object.MemberwiseClone Object.MemberwiseClone Object.MemberwiseClone Method

Definition

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

protected:
 System::Object ^ MemberwiseClone();
protected object MemberwiseClone ();
member this.MemberwiseClone : unit -> obj
Protected Function MemberwiseClone () As Object

Gibt zurück

Eine flache Kopie des aktuellen Object.A shallow copy of the current Object.

Beispiele

Im folgenden Beispiel wird die MemberwiseClone -Methode veranschaulicht.The following example illustrates the MemberwiseClone method. Es definiert eine ShallowCopy Methode, die die MemberwiseClone -Methode aufruft, um einen flachen Kopiervorgang Person für ein-Objekt auszuführen.It defines a ShallowCopy method that calls the MemberwiseClone method to perform a shallow copy operation on a Person object. Außerdem wird eine DeepCopy Methode definiert, die einen Deep Copy-Vorgang für Person ein-Objekt ausführt.It also defines a DeepCopy method that performs a deep copy operation on a Person object.

using System;

public class IdInfo
{
    public int IdNumber;
    
    public IdInfo(int IdNumber)
    {
        this.IdNumber = IdNumber;
    }
}

public class Person 
{
    public int Age;
    public string Name;
    public IdInfo IdInfo;

    public Person ShallowCopy()
    {
       return (Person) this.MemberwiseClone();
    }

    public Person DeepCopy()
    {
       Person other = (Person) this.MemberwiseClone();
       other.IdInfo = new IdInfo(IdInfo.IdNumber);
       other.Name = String.Copy(Name);
       return other;
    }
}

public class Example
{
    public static void Main()
    {
        // Create an instance of Person and assign values to its fields.
        Person p1 = new Person();
        p1.Age = 42;
        p1.Name = "Sam";
        p1.IdInfo = new IdInfo(6565);

        // Perform a shallow copy of p1 and assign it to p2.
        Person p2 = p1.ShallowCopy();

        // Display values of p1, p2
        Console.WriteLine("Original values of p1 and p2:");
        Console.WriteLine("   p1 instance values: ");
        DisplayValues(p1);
        Console.WriteLine("   p2 instance values:");
        DisplayValues(p2);
        
        // Change the value of p1 properties and display the values of p1 and p2.
        p1.Age = 32;
        p1.Name = "Frank";
        p1.IdInfo.IdNumber = 7878;
        Console.WriteLine("\nValues of p1 and p2 after changes to p1:");
        Console.WriteLine("   p1 instance values: ");
        DisplayValues(p1);
        Console.WriteLine("   p2 instance values:");
        DisplayValues(p2);

        // Make a deep copy of p1 and assign it to p3.
        Person p3 = p1.DeepCopy();
        // Change the members of the p1 class to new values to show the deep copy.
        p1.Name = "George";
        p1.Age = 39;
        p1.IdInfo.IdNumber = 8641;
        Console.WriteLine("\nValues of p1 and p3 after changes to p1:");
        Console.WriteLine("   p1 instance values: ");
        DisplayValues(p1);
        Console.WriteLine("   p3 instance values:");
        DisplayValues(p3);
    }

    public static void DisplayValues(Person p)
    {
        Console.WriteLine("      Name: {0:s}, Age: {1:d}", p.Name, p.Age);
        Console.WriteLine("      Value: {0:d}", p.IdInfo.IdNumber);
    }
}
// The example displays the following output:
//       Original values of p1 and p2:
//          p1 instance values:
//             Name: Sam, Age: 42
//             Value: 6565
//          p2 instance values:
//             Name: Sam, Age: 42
//             Value: 6565
//       
//       Values of p1 and p2 after changes to p1:
//          p1 instance values:
//             Name: Frank, Age: 32
//             Value: 7878
//          p2 instance values:
//             Name: Sam, Age: 42
//             Value: 7878
//       
//       Values of p1 and p3 after changes to p1:
//          p1 instance values:
//             Name: George, Age: 39
//             Value: 8641
//          p3 instance values:
//             Name: Frank, Age: 32
//             Value: 7878
Public Class IdInfo
    Public IdNumber As Integer
    
    Public Sub New(IdNumber As Integer)
        Me.IdNumber = IdNumber
    End Sub
End Class

Public Class Person 
    Public Age As Integer
    Public Name As String
    Public IdInfo As IdInfo

    Public Function ShallowCopy() As Person
       Return DirectCast(Me.MemberwiseClone(), Person)
    End Function

    Public Function DeepCopy() As Person
       Dim other As Person = DirectCast(Me.MemberwiseClone(), Person) 
       other.IdInfo = New IdInfo(IdInfo.IdNumber)
       other.Name = String.Copy(Name)
       Return other
    End Function
End Class

Module Example
   Public Sub Main()
        ' Create an instance of Person and assign values to its fields.
        Dim p1 As New Person()
        p1.Age = 42
        p1.Name = "Sam"
        p1.IdInfo = New IdInfo(6565)

        ' Perform a shallow copy of p1 and assign it to p2.
        Dim p2 As Person = p1.ShallowCopy()

        ' Display values of p1, p2
        Console.WriteLine("Original values of p1 and p2:")
        Console.WriteLine("   p1 instance values: ")
        DisplayValues(p1)
        Console.WriteLine("   p2 instance values:")
        DisplayValues(p2)
        Console.WriteLine()
                
        ' Change the value of p1 properties and display the values of p1 and p2.
        p1.Age = 32
        p1.Name = "Frank"
        p1.IdInfo.IdNumber = 7878
        Console.WriteLine("Values of p1 and p2 after changes to p1:")
        Console.WriteLine("   p1 instance values: ")
        DisplayValues(p1)
        Console.WriteLine("   p2 instance values:")
        DisplayValues(p2)
        Console.WriteLine()
        
        ' Make a deep copy of p1 and assign it to p3.
        Dim p3 As Person = p1.DeepCopy()
        ' Change the members of the p1 class to new values to show the deep copy.
        p1.Name = "George"
        p1.Age = 39
        p1.IdInfo.IdNumber = 8641
        Console.WriteLine("Values of p1 and p3 after changes to p1:")
        Console.WriteLine("   p1 instance values: ")
        DisplayValues(p1)
        Console.WriteLine("   p3 instance values:")
        DisplayValues(p3)
   End Sub
   
    Public Sub DisplayValues(p As Person)
        Console.WriteLine("      Name: {0:s}, Age: {1:d}", p.Name, p.Age)
        Console.WriteLine("      Value: {0:d}", p.IdInfo.IdNumber)
    End Sub
End Module
' The example displays the following output:
'       Original values of m1 and m2:
'          m1 instance values:
'             Name: Sam, Age: 42
'             Value: 6565
'          m2 instance values:
'             Name: Sam, Age: 42
'             Value: 6565
'       
'       Values of m1 and m2 after changes to m1:
'          m1 instance values:
'             Name: Frank, Age: 32
'             Value: 7878
'          m2 instance values:
'             Name: Sam, Age: 42
'             Value: 7878
'       
'       Values of m1 and m3 after changes to m1:
'          m1 instance values:
'             Name: George, Age: 39
'             Value: 8641
'          m3 instance values:
'             Name: Frank, Age: 32
'             Value: 7878

In diesem Beispiel gibt die Person.IdInfo -Eigenschaft ein IdInfo -Objekt zurück.In this example, the Person.IdInfo property returns an IdInfo object. Wie die Ausgabe des Beispiels zeigt, ist das Person geklonte Person Objekt, wenn ein- MemberwiseClone Objekt durch Aufrufen der-Methode geklont wird, eine unabhängige Kopie des ursprünglichen-Objekts, mit dem Person.IdInfo Unterschied, dass Sie denselben Objekt Verweis gemeinsam verwenden.As the output from the example shows, when a Person object is cloned by calling the MemberwiseClone method, the cloned Person object is an independent copy of the original object, except that they share the same Person.IdInfo object reference. Dadurch ändert sich die- Person.IdInfo Person.IdInfo Eigenschaft des ursprünglichen-Objekts durch Ändern der-Eigenschaft des Klons.As a result, modifying the clone's Person.IdInfo property changes the original object's Person.IdInfo property. Wenn dagegen ein Deep Copy-Vorgang ausgeführt wird, kann das geklonte Person Objekt, einschließlich seiner Person.IdInfo -Eigenschaft, geändert werden, ohne dass sich dies auf das ursprüngliche Objekt auswirkt.On the other hand, when a deep copy operation is performed, the cloned Person object, including its Person.IdInfo property, can be modified without affecting the original object.

Hinweise

Die MemberwiseClone -Methode erstellt eine flache Kopie, indem ein neues-Objekt erstellt und dann die nicht statischen Felder des aktuellen-Objekts in das neue-Objekt kopiert werden.The MemberwiseClone method creates a shallow copy by creating a new object, and then copying the nonstatic fields of the current object to the new object. Wenn ein Feld ein Werttyp ist, wird eine Bit-für-Bit-Kopie des Felds ausgeführt.If a field is a value type, a bit-by-bit copy of the field is performed. Wenn ein Feld ein Referenztyp ist, wird der Verweis kopiert, aber das Objekt, auf das verwiesen wird, nicht. Daher verweisen das ursprüngliche Objekt und der zugehörige Klon auf dasselbe Objekt.If a field is a reference type, the reference is copied but the referred object is not; therefore, the original object and its clone refer to the same object.

Angenommen, ein Objekt mit dem Namen X verweist auf die Objekte A und B. Object B wiederum verweist auf Objekt C. Eine flache Kopie von X erstellt ein neues Objekt x2, das auch auf die Objekte A und B verweist. Im Gegensatz dazu erstellt eine tiefe Kopie von X ein neues Objekt x2, das auf die neuen Objekte a2 und B2 verweist, die Kopien von a und B. B2 wiederum auf das neue Objekt C2, das eine Kopie von C ist. Das Beispiel veranschaulicht den Unterschied zwischen einem flachen und einem Deep Copy-Vorgang.For example, consider an object called X that references objects A and B. Object B, in turn, references object C. A shallow copy of X creates new object X2 that also references objects A and B. In contrast, a deep copy of X creates a new object X2 that references the new objects A2 and B2, which are copies of A and B. B2, in turn, references the new object C2, which is a copy of C. The example illustrates the difference between a shallow and a deep copy operation.

Es gibt zahlreiche Möglichkeiten, einen Deep Copy-Vorgang zu implementieren, wenn der flache Kopier MemberwiseClone Vorgang, der von der-Methode ausgeführt wird, nicht Ihren Anforderungen entspricht.There are numerous ways to implement a deep copy operation if the shallow copy operation performed by the MemberwiseClone method does not meet your needs. Hierzu gehört Folgendes:These include the following:

  • Rufen Sie einen Klassenkonstruktor des Objekts auf, das kopiert werden soll, um ein zweites Objekt mit Eigenschafts Werten zu erstellen, die aus dem ersten Objekt entnommen werdenCall a class constructor of the object to be copied to create a second object with property values taken from the first object. Dabei wird davon ausgegangen, dass die Werte eines Objekts vollständig durch den Klassenkonstruktor definiert werden.This assumes that the values of an object are entirely defined by its class constructor.

  • Rufen Sie MemberwiseClone die-Methode auf, um eine flache Kopie eines Objekts zu erstellen, und weisen Sie dann neue Objekte zu, deren Werte mit dem ursprünglichen Objekt identisch sind, und zwar für alle Eigenschaften oder Felder, deren Werte Verweis Typen sind.Call the MemberwiseClone method to create a shallow copy of an object, and then assign new objects whose values are the same as the original object to any properties or fields whose values are reference types. Diese DeepCopy Vorgehensweise wird von der-Methode im Beispiel veranschaulicht.The DeepCopy method in the example illustrates this approach.

  • Serialisieren Sie das Objekt, das tief kopiert werden soll, und stellen Sie die serialisierten Daten dann in einer anderen Objektvariablen wieder her.Serialize the object to be deep copied, and then restore the serialized data to a different object variable.

  • Verwenden Sie Reflektion mit Rekursion, um den Deep Copy-Vorgang auszuführen.Use reflection with recursion to perform the deep copy operation.

Gilt für: