Datensitzungs-Manager (Foundation Class)
| Kategorie | Anwendung |
|---|---|
| Standardkatalog | Visual FoxPro-Katalog\Foundation Classes\Anwendung |
| Klasse | _datassession |
| Basisklasse | Custom |
| Klassenbibliothek | _app.vcx |
| Übergeordnete Klasse | _custom |
| Beispiel | ...\Samples\Solution\Ffc\environ.scx |
Hinweise
Diese Klasse dient zur Verwaltung von Datensitzungen und zur Handhabung der Datenaktualisierung in allen Formularen und Formularsätzen der aktuellen Datensitzung. Sie aktiviert ein Anwendungsobjekt (Application-Objekt), um leicht durch verschiedene Sitzungen iterieren zu können, damit bei Exit oder Shutdown ein fensterschließendes Verhalten möglich ist. Außerdem stellt sie für Formulare und Formularsätze ein generisches QueryUnload-Verhalten bereit sowie generischen sitzungsweiten Update- und Revertcode. Mit dieser Klasse können Sie vor der Verwendung Ihrer eigenen Prozedur zur Konfliktbehandlung feststellen, ob in einer Sitzung Daten geändert wurden.
Diese Klasse arbeitet sowohl mit freien Tabellen als auch mit Tabellen in Datenbanken. Beachten Sie die Transaktionsbeschränkung (5).
Um die Klasse zu verwenden, müssen Sie sie in ein Projekt oder Formular ziehen oder im Kontextmenü des Komponentensammlungselements den Befehl Zu Projekt hinzufügen oder Zu Formular hinzufügen wählen. Wenn Sie die Klasse zu einem Formular hinzufügen, positioniert Visual FoxPro die Klasse im Formular. Sie können dann die entsprechenden Eigenschaftswerte spezifizieren und notwendige Eingabe- und Ausgabeobjekte bereitstellen. Wenn Sie die Klasse in ein Projekt ziehen, haben Sie die Auswahl zwischen dem Hinzufügen der Klasse und dem Erstellen einer Unterklasse.
Weitere Informationen zur Verwendung der Foundation Classes finden Sie unter Richtlinien zur Verwendung der Visual FoxPro Foundation Classes.
| Eigenschaften, Ereignisse, Methoden | Beschreibung |
| iDataChangedMode-Eigenschaft | Gibt den Typ der durchgeführten Datenänderung an.
0 – Alles geändert. Standardwert: 0 |
| iSavedSessionID-Eigenschaft | Gibt einen ganzzahligen Wert an, der die ID der gespeicherten Sitzung darstellt. Standardwert: 1 |
| lSuccess-Eigenschaft | Gibt an, ob die Datenoperation (Aktualisierung) erfolgreich war. Standardwert: .T. |
| lUseTransactions-Eigenschaft | Gibt an, ob die Aktualisierungsroutine in eine Transaktion eingebettet wird.
Anmerkung Transaktionen betreffen nur Tabellen in Datenbankcontainern (DBC). Standardwert: .T. |
| DataChanged-Methode | Überprüft, ob Daten geändert wurden. Syntax: DataChanged( ) Rückgabewert: keiner Argumente: keine |
| DataFlush-Methode | Stellt sicher, dass das aktive Steuerelement seinen aktuellen Inhalt "erkennt", und zwar auch dann, wenn Sie die Aktualisierung über eine Symbolleistenschaltfläche auslösen, während ein Raster den Fokus besitzt. Syntax: DataFlush( ) Rückgabewert: keiner Argumente: keine |
| GetActiveControlRef-Methode | Gibt das tatsächlich aktive Steuerelement (loRealActiveControl) zurück, falls das derzeit aktive Steuerelement ein Raster ist. Syntax: GetActiveControlRef(toActiveControl) Rückgabewert:loRealActiveControl Argumente: toActiveControl gibt das aktuelle Steuerelement an. |
| GetMessageBoxTitle-Methode | Gibt einen Teil des Titelzeilentextes zurück, der den Namen der Meldung angibt. Syntax: GetMessageBoxTitle( ) Rückgabewert:cTitlebarText Argumente: keine |
| QueryUnload-Methode | Stellt Dialogfelder zur Verwaltung der Datenänderungsentscheidungen bereit. Syntax: QueryUnload(tlDataChangeAlreadyConfirmed, toForm, tlNoShow) Rückgabewert:liResult Argumente: tlDataChangeAlreadyConfirmed gibt an, ob Daten geändert wurden. toForm gibt das Formular an. tlNoShow gibt an, ob das Formular angezeigt wird. liResult gibt das Meldungsfeld oder den Wert an. |
| RestoreSessionID-Methode | Stellt die Datensitzung wieder her. Syntax: RestoreSessionID( ) Rückgabewert: keiner Argumente: keine |
| Revert-Methode | Stellt die Originaldaten der Sitzung wieder her. Syntax: Revert(tlUserChoiceAlreadyConfirmed, tlDataChangeAlreadyConfirmed, toForm, tlNoShow) Rückgabewert: keiner Argumente: tlUserChoiceAlreadyConfirmed gibt an, ob ein Bestätigungsdialogfeld angezeigt wird. tlDataChangeAlreadyConfirmed gibt an, ob ein Bestätigungsdialogfeld angezeigt wird. toForm gibt das Formular an. tlNoShow gibt an, ob das Formular angezeigt wird. |
| SetSessionID-Methode | Setzt die Datensitzung. Syntax: SetSessionID( ) Rückgabewert: keiner Argumente: keine |
| Update-Methode | Aktualisiert Daten. Syntax: Update(tlUserChoiceAlreadyConfirmed, tlDataChangeAlreadyConfirmed, toForm, tlNoShow) Rückgabewert: keiner Argumente: tlUserChoiceAlreadyConfirmed gibt an, ob ein Bestätigungsdialogfeld angezeigt wird. tlDataChangeAlreadyConfirmed gibt an, ob ein Bestätigungsdialogfeld angezeigt wird. toForm gibt das Formular an. tlNoShow gibt an, ob das Formular angezeigt wird. |
Siehe auch
Richtlinien zur Verwendung der Visual FoxPro Foundation Classes | Visual FoxPro Foundation Classes A-Z | Visual FoxPro Foundation Classes