Data.DB.TDataSet.State

Übergeordnet: TDataSet

Delphi

property State: TDataSetState read FState;

C++

__property TDataSetState State = {read=FState, nodefault};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

Beschreibung

Gibt den aktuellen Modus der Datenmenge an.

Mit State können Sie den aktuellen Status einer Datenmenge ermitteln. Der Modus bestimmt, welche Operationen mit den Daten in der Datenmenge durchgeführt werden können (z.B. Bearbeiten vorhandener oder Einfügen neuer Datensätze). Der Modus ändert sich bei der Verarbeitung der Daten in einer Anwendung ständig.

Beim Öffnen einer Datenmenge ändert sich der Modus von dsInactive in dsBrowse. Die Datenmenge kann dann mit der Methode Edit in den Modus dsEdit oder mit Insert in den Modus dsInsert versetzt werden. Bei einem TTable- oder TClientDataSet-Objekt kann der Modus mit SetKey oder SetRange in dsSetKey geändert werden.

Durch das Eintragen oder Verwerfen von Änderungen sowie das Einfügen oder Löschen von Datensätzen wird der aktuelle Status in dsBrowse geändert. Wird eine Datenmenge geschlossen, ändert sich ihr Modus in dsInactive.

Einige Modi wie dsCalcFields, dsFilter, dsNewValue, dsOldValue und dsCurValue können nicht direkt ermittelt oder gesetzt werden. Sie werden automatisch zugewiesen, wenn OnCalcFields und OnFilterRecord-Ereignisse ausgelöst werden oder in einer Anwendung auf bestimmte Feldeigenschaften zugegriffen wird.