DataSessionID-Eigenschaft

Gibt die ID der Datensitzung zurück, über die die private Datensitzung für das Objekt angegeben wird. Diese Eigenschaft ist zur Entwurfszeit schreibgeschützt und kann zur Laufzeit gelesen und eingestellt werden.

Ist die DataSession-Eigenschaft des Objekts auf 1 festgelegt (Standarddatensitzung), wird die ID der Standarddatensitzung zurückgegeben.

Object.DataSessionID

Hinweise

Diese Eigenschaft ist nur dann verfügbar, wenn die DataSession-Eigenschaft des Objekts auf 2 festgelegt ist (private Datensitzung).

Sie können den SET DATASESSION-Befehl zusammen mit der DataSessionID-Eigenschaft verwenden, um Datensitzungen zu ändern.

Wenn Sie die DataSessionID festlegen, betrifft diese Einstellung die aktuelle Datensitzung des Objekts. Nicht davon betroffen sind Objekte, die mit CREATEOBJECT( ) erstellt wurden.

Durch das Ändern der Einstellung der DataSessionID-Eigenschaft wird der Verweiszähler der Datensitzung, in die gewechselt wird, erhöht und der Verweiszähler der Datensitzung, aus der gewechselt wurde, verringert. Wenn jedoch eine Datensitzung erstellt wurde, indem für die DataSession-Eigenschaft der Wert 2 (private Datensitzung) festgelegt wurde, wird durch das Ändern der DataSessionID-Eigenschaft nicht die ursprüngliche Datensitzung freigegeben. In diesem Fall muss zur Freigabe der ursprünglichen Datensitzung das Objekt freigegeben werden.

Weitere Informationen zum Verwenden mehrerer Datensitzungen finden Sie unter Programmieren für gemeinsamen Zugriff.

Vorsicht   Das Ändern der Einstellung der DataSessionID-Eigenschaft für ein Objekt, das datengebundene Steuerelemente enthält, löst die Verbindung des Steuerelements zu den ursprünglichen Datenquellen. Sie sollten deshalb DataSessionID nur für Objekte verwenden, die keine datengebundenen Steuerelemente enthalten.

Siehe auch

CREATEOBJECT( ) | DataSession-Eigenschaft | SET DATASESSION

Betrifft: Formularobjekt | Formularsatz-Objekt | _SCREEN-Systemvariable | Sitzungsobjekt | Symbolleisten-Objekt