System.TObject.DisposeOf

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DisposeOf; {$IFNDEF AUTOREFCOUNT} inline; {$ENDIF}

C++

void __fastcall DisposeOf(void);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.pas
systobj.h
System TObject

Beschreibung

DisposeOf veranlasst die Ausführung des Destruktors in einem Objekt.

Die neuen mobilen Delphi-Compiler führen ein neues Dispose-Muster ein, das durch den Aufruf der Methode DisposeOf implementiert wird, die den Destruktorcode ausführt, auch wenn Variablen mit ausstehenden Referenzen auf das Objekt vorhanden sind. Nach dem Aufruf der Methode DisposeOf wird das Objekt in einen bestimmten Status gesetzt, den Disposed-Status. Das bedeutet, dass der Destruktor nicht erneut aufgerufen wird, wenn DisposeOf wieder aufgerufen wird oder wenn der Referenzzähler null erreicht (wenn der Speicher freigegeben wird).

Das Verhalten von DisposeOf ist für die beiden Generationen von Delphi-Compilern unterschiedlich:

  • Bei den Delphi-Desktop-Compilern (DCC32, DCC64, DCCOSX) bleibt die Auswirkung des Aufrufs von DisposeOf unverändert, wie beim Aufrufen von Free.
  • Bei den mobilen Delphi-Compilern (DCCIOS32, DCCIOSARM) wird der Destruktorcode zum gleichen Zeitpunkt wie bei den Delphi-Desktop-Compilern ausgeführt, aber der Speicher wird von der automatischen Referenzzählung verwaltet.
type
  TMySimpleClass = class
  private
    //
    stringMember: String;
    constructor Create(Text: String);
    destructor Destroy;
  end;

constructor TMySimpleClass.Create(Text: String);
begin
  stringMember := Text;
end;

destructor TMySimpleClass.Destroy;
begin
  // dies wird beim Aufrufen der Methode DisposeOf ausgeführt.
end;

var
  myObject: TMySimpleClass;
begin
  myObject := TMySimpleClass.Create
    ('This is a code snippet indicating the usage of the DisposeOf method');
  if not myObject.Disposed then
    myObject.DisposeOf;
  //Ab hier befindet sich das Objekt im Disposed-Status.
end.

Siehe auch