DbConnectionInfo Klassenreferenz

Hilfsklasse zur Einstellung der Verbingungsparameter. Mehr ...

Öffentliche Methoden
Event	DbmsConnectionChanged (ByVal newCID As String)
	Ereignis wenn sich die Verbindung ändert.
Event	DbmsConnectionInfoCleared ()
	Ereignis wenn sich die Verbindung ändert.
Event	DbmsInfoMessage (ByVal Source As String, ByVal Msg As String, ByVal MsgStyle As VbMsgBoxStyle)
	Ereignis zur Weitergabe von Informationen.
Event	DbConnectionInfoError (ByVal ErrNumber As Long, ByVal Source As String, ByVal ErrDescription As String, ByRef Response As AcUtilErrorResumeMode)
	Ereignis für Fehlermeldungen.
Function	CheckConnection (Optional ByRef ErrMsg As String=vbNullString) As Boolean
	Verbindung zum Server bzw. Datenbank prüfen.
Property Get	OledbConnectionString () As String
	OledbConnectionString.
Property Get	OdbcConnectionString (Optional ByVal bWithoutUserInfo As Boolean=False) As String
	OdbcConnectionString.
Property Get	DbUser (Optional ByVal withoutServerCheck As Boolean=False) As String
	Name des Datenbankbenutzers.
Property Get	DbUserPassword () As String
	Passwort des Datenbankbenutzers, das bei Anmeldung eingegeben wurde.
Property Get	SavePassword () As Boolean
	Einstellung aus den Verbindungsparametern, ob Passwort bei verknüpften Tabellen gespeichert werden soll.
Property Get	UseLoginForm () As Boolean
	Einstellung aus den Verbindungsparametern, ob beim Anmelden das Login-Formular verwendet werden soll.
Sub	ClearConnectionInfo ()
	Eingestellte Verbindungsparameter löschen.
Function	ChangeDbUserPassword (ByVal NewPassword As String, ByVal OldPassword As String, Optional ByVal LoginName As String=vbNullString, Optional ByRef Msg As String) As Boolean
	Datenbankpasswort des Benutzers ändern.
Property Get	PermanentBackendRstSqlText () As String
	Select-Anweisung für ODBC-Recordsetverbindung zum Aufrechterhalten der Verbindung.
Property Get	ConnectionStrings () As DbmsConnectionStrings
	ODBC- und OLEDB-Connectionstring.
Property Get	TableListSqlText () As String
	SQL-Anweisung im SQL-Dialtekt des DBMS zur Auflistung der im DBS enthaltenen Tabellen.
Function	ParseTableName (ByVal sTabName As String) As String
	Hilfsprozedur zum Anpassen des Tabellennamens.

Ausführliche Beschreibung

Hilfsklasse zur Einstellung der Verbingungsparameter.

Dokumentation der Elementfunktionen

Function ChangeDbUserPassword	(	ByVal NewPassword As	String,
		ByVal OldPassword As	String,
		Optional ByVal LoginName As	String = `vbNullString`,
		Optional ByRef Msg As	String
	)

Datenbankpasswort des Benutzers ändern.

Parameter:

	NewPassword	Neues Passwort
	OldPassword	Altes Passwort
	LoginName	Benutzername (Falls kein Benutzername übergeben wird, wird der aktuelle Benutzer eingesetzt)
	Msg	ByRef-Parameter zur Rückgabe einer Fehlermeldung, falls das Passwort nicht geändert werden könnte

Rückgabe:: Boolean: True = Passwort wurde geändert

Function CheckConnection ( Optional ByRef ErrMsg As String = vbNullString )

Verbindung zum Server bzw. Datenbank prüfen.

Parameter:

ErrMsg

Fehlermeldung vom ADODB- bzw. ODBC-Verbindungsaufbau

Rückgabe:: Boolean: True = Ado- und ODBC-Verbindung konnten aufgebaut werden

Als erster Test erfolgt der ADO-Verbindungsaufbau. Sobald dieser erfolgreich war, wird der ODBC-Verbindungsaufbau getestet.

Sub ClearConnectionInfo ( )

Eingestellte Verbindungsparameter löschen.

Erfordert erneutes Einlesen aus Tabelle, wenn die Verbidnungsdaten angefordert werden.

Property Get ConnectionStrings ( )

ODBC- und OLEDB-Connectionstring.

Rückgabe:: DbmsConnectionStrings

Diese Prozedur muss erweitert werden, wenn weitere DBMS (wie Oracle) eingesetzt werden sollen.

Event DbConnectionInfoError	(	ByVal ErrNumber As	Long,
		ByVal Source As	String,
		ByVal ErrDescription As	String,
		ByRef Response As	AcUtilErrorResumeMode
	)

Ereignis für Fehlermeldungen.

Parameter:

	ErrNumber	Fehlernummer
	Source	Prozedur(en) in der der Fehler auftrat
	ErrDescription	Fehlerbeschreibung
	Response	AcUtilErrorResumeMode-Wert (ermöglich Fehlersteuerung als Reaktion auf das Ereignis)

Ermöglich die Behebung bzw. die Behandlung des Fehlers

Event DbmsConnectionChanged ( ByVal newCID As String )

Ereignis wenn sich die Verbindung ändert.

Parameter:

	ErrNumber	Fehlernummer
	Source	Prozedur(en) in der der Fehler auftrat
	ErrDescription	Fehlerbeschreibung
	Response	AcUtilErrorResumeMode-Wert (ermöglich Fehlersteuerung als Reaktion auf das Ereignis)

Kann nützlich sein, wenn in Abhängigkeit der Verbindung Anzeigen aktualisiert werden usw.

Event DbmsConnectionInfoCleared ( )

Ereignis wenn sich die Verbindung ändert.

Parameter:

	ErrNumber	Fehlernummer
	Source	Prozedur(en) in der der Fehler auftrat
	ErrDescription	Fehlerbeschreibung
	Response	AcUtilErrorResumeMode-Wert (ermöglich Fehlersteuerung als Reaktion auf das Ereignis)

Kann nützlich sein, wenn in Abhängigkeit der Verbindung Anzeigen aktualisiert werden usw.

Event DbmsInfoMessage	(	ByVal Source As	String,
		ByVal Msg As	String,
		ByVal MsgStyle As	VbMsgBoxStyle
	)

Ereignis zur Weitergabe von Informationen.

Parameter:

	ErrNumber	Fehlernummer
	Source	Prozedur(en) in der der Fehler auftrat
	ErrDescription	Fehlerbeschreibung
	Response	AcUtilErrorResumeMode-Wert (ermöglich Fehlersteuerung als Reaktion auf das Ereignis)

Dient zur Weitergabe von Infos (ähnlich debug.print)

Property Get DbUser ( Optional ByVal withoutServerCheck As Boolean = False )

Name des Datenbankbenutzers.

Parameter:

withoutServerCheck

True = Keine Prüfung durchführen, ob Verbidnungsdaten bereits eingelesen wurden

Rückgabe:: String

Property Get DbUserPassword ( )

Passwort des Datenbankbenutzers, das bei Anmeldung eingegeben wurde.

'nicht exportieren (2. * für Export fehlt)

Rückgabe:: String

Das Passwort sollte normalerweise nie abgefragt werden müssen und nur zur Weitergabe innerhalb der Klassenstruktur benutzt werden.

Property Get OdbcConnectionString ( Optional ByVal bWithoutUserInfo As Boolean = False )

OdbcConnectionString.

Parameter:

bWithoutUserInfo

False = Benutzerkennung ist im ODBC-Connectionstring nethalten, True = ohne Benutzerkennung

Rückgabe:: String

Das Einstellen des Parameters bWithoutUserInfo ist normalerweise nicht erforderlich, kann jedoch hilfreich sein, falls der ODBC-Connectionstring ohne Passwort angezeigt werden soll.

Property Get OledbConnectionString ( )

OledbConnectionString.

Rückgabe:: String

Function ParseTableName ( ByVal sTabName As String )

Hilfsprozedur zum Anpassen des Tabellennamens.

Parameter:

sTabName

Tabellename

Rückgabe:: String

Bei manchen DBMS muss Groß- o. Kleinschreibung beachtet bzw. der Name mit Sonderzeichen eingeklammert werden.

Property Get PermanentBackendRstSqlText ( )

Select-Anweisung für ODBC-Recordsetverbindung zum Aufrechterhalten der Verbindung.

Rückgabe:: String

Diese Prozedur muss erweitert werden, wenn weitere DBMS (wie Oracle) eingesetzt werden sollen.

Property Get SavePassword ( )

Einstellung aus den Verbindungsparametern, ob Passwort bei verknüpften Tabellen gespeichert werden soll.

Rückgabe:: Boolean

Property Get TableListSqlText ( )

SQL-Anweisung im SQL-Dialtekt des DBMS zur Auflistung der im DBS enthaltenen Tabellen.

Rückgabe:: String

Diese Prozedur muss erweitert werden, wenn weitere DBMS (wie Oracle) eingesetzt werden sollen.

Property Get UseLoginForm ( )

Einstellung aus den Verbindungsparametern, ob beim Anmelden das Login-Formular verwendet werden soll.

Rückgabe:: Boolean

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

DbConnectionInfo.bas

DbConnectionInfo Klassenreferenz

Öffentliche Methoden

Ausführliche Beschreibung

Dokumentation der Elementfunktionen