Data.DB.TCustomConnection.LoginPrompt

Übergeordnet: TCustomConnection

Delphi

property LoginPrompt: Boolean read FLoginPrompt write FLoginPrompt default False;

C++

__property bool LoginPrompt = {read=FLoginPrompt, write=FLoginPrompt, default=0};

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

Eigenschaften

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

Beschreibung

Gibt an, ob unmittelbar vor dem Öffnen einer neuen Verbindung ein Anmeldedialog angezeigt wird.

Wenn LoginPrompt auf true gesetzt ist, wird beim Herstellen einer Verbindung ein Anmeldedialog angezeigt. LoginPrompt steuert folgendes: Das Eintreten des Ereignisses OnLogin und das Erscheinungsbild des Standard-Anmeldedialogs. In dem Anmeldedialog muss der Benutzer einen Namen und ein Passwort eingeben, wenn Sie DBLogDlg.hpp der Unit (C++) oder der uses-Klausel DBLogDlg (Delphi) hinzufügen. Wann das Ereignis OnLogin ausgelöst und der Standard-Anmeldedialog angezeigt wird, hängt von der Art der Verbindungskomponenten ab:

Bei TDatabase, TIBDatabase und TSQLConnection-Komponenten wird das Dialogfeld zwischen den Ereignissen BeforeConnect und AfterConnect angezeigt, wenn keine Behandlungsroutine für das Ereignis OnLogin implementiert ist. Andernfalls wird diese Routine anstelle des Dialogs aufgerufen, und es ist nicht erforderlich, DBLogDlg.hpp der Unit (C++) oder DBLogDlg der uses-Klausel (Delphi) hinzuzufügen. Wenn weder in diesem Dialog noch in der Behandlungsroutine korrekte Werte übergeben werden, kommt keine Verbindung zustande. Das Ereignis OnLogin wird nur ausgelöst, wenn LoginPrompt den Wert true hat.
Bei TADOConnection-Verbindungskomponenten wird das Dialogfeld nach dem Ereignis OnWillConnect, aber vor BeforeConnect angezeigt. Wenn eine Ereignisbehandlungsroutine für OnLogin implementiert ist, wird das Ereignis nach der Anmeldung ausgelöst. Wenn Sie die Datei DBLogDlg.hpp nicht in Ihre Unit einbinden (C++) oder DBLogDlg zu Ihrer uses-Klausel hinzufügen (Delphi), wird das Ereignis OnLogin zwar ausgelöst, aber kein Standarddialogfeld zur Anmeldung angezeigt. Wenn weder in diesem Dialog noch in der Behandlungsroutine korrekte Werte übergeben werden, kommt keine Verbindung zustande. Das Ereignis OnLogin wird nur ausgelöst, wenn LoginPrompt den Wert true hat.
Bei DataSnap SOAP-Verbindungskomponenten wird das Dialogfeld nach dem Ereignis OnGetUsenName, aber vor den Ereignissen BeforeConnect, AfterConnect und OnLogin angezeigt. Wenn der Benutzer auf die Schaltfläche Abbrechen des Dialogs klickt, wird keine Verbindung hergestellt.

Wird LoginPrompt auf false gesetzt, müssen Benutzername und Kennwort auf eine der folgenden Arten im Programmcode übergeben werden:

Bei der Komponente TDatabase können die Werte als Parameter USER_NAME und PASSWORD in der Eigenschaft Params angegeben werden.
Bei TADOConnection können Benutzername und Passwort mit der Eigenschaft ConnectionString angegeben werden.
Bei der Komponente TSQLConnection können die Werte mit den Parametern UserName, Password und Database in der Eigenschaft Params übergeben oder als dem Verbindungsnamen zugeordnete Parameter übergeben werden.
Bei DataSnap SOAP-Verbindungskomponenten gibt es keine integrierte Verwendung für Benutzername und Passwort. (die Eigenschaften UserName und Password von TWebConnection werden nicht verwendet).

Warnung: Wenn Sie den Benutzernamen und das Kennwort als Eigenschaftswert oder im Quelltext der Ereignisbehandlungsroutine für OnLogin übergeben, beeinträchtigen Sie dadurch die Serversicherheit.