System.Classes.TPersistent.Assign
Delphi
procedure Assign(Source: TPersistent); virtual;
C++
virtual void __fastcall Assign(TPersistent* Source);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TPersistent |
Beschreibung
Kopiert den Inhalt eines Objekts in ein anderes.
Mit Assign kopieren Sie die Eigenschaften und andere Attribute eines Objekts aus einem anderen. Ein Aufruf von Assign hat die grundsätzlich folgende Form:
Destination.Assign(Source); {Delphi}
Destination->Assign(Source); // C++
Dadurch wird das Zielobjekt (Destination) angewiesen, den Inhalt des Quellobjekts (Source) auf sich selbst zu kopieren.
In den meisten Anwendungen wird Assign überschrieben, um die Zuweisung von Eigenschaften aus ähnlichen Objekten vorzunehmen. Wenn das Zielobjekt die Zuweisung von Eigenschaften aus Source nicht behandeln kann, rufen Sie beim Überschreiben von Assign die geerbte Methode auf.
Wenn keine überschriebene Methode die Zuweisung von Eigenschaften aus Source behandeln kann, ruft die in TPersistent implementierte Methode die Methode AssignTo des Quellobjekts auf. Dadurch kann das Quellobjekt die Zuweisung bearbeiten. Wenn das Source-Objekt nil (Delphi) bzw. NULL (C++) ist, löst Assign eine EConvertError-Exception aus.
Im allgemeinen ist die Anweisung
Destination := Source; {Delphi}
Destination = Source; // C++
nicht identisch mit der Anweisung
Destination.Assign(Source); {Delphi}
Destination->Assign(Source); // C++
Der Zuweisungsoperator bewirkt, dass Destination dasselbe Objekt wie Source referenziert, wobei die Methode Assign den Inhalt des in Source referenzierten Objekts in das von Destination referenzierte Objekt kopiert.
Anmerkung: Die Typen einiger Eigenschaften sind ebenfalls Objekte. Wenn diese Eigenschaften Methoden besitzen, die Eigenschaftswerte mit Assign setzen, dann führt der Zuweisungsoperator dasselbe wie die Methode Assign aus.