ADO Konstanten und die Datei Adovbs.inc

Geschrieben von: Christian Koller
Kategorie: ASP Grundlagen

Wenn Sie ADO unter ASP einsetzen, so werden Sie beim Benutzen der diversen Methoden und Eigenschaften des Recordset- und des Connection Objektes immer wieder ADO Konstanten benötigen. Diese Konstanten enthalten numerische Werte, die für bestimmte Attribute im Zusammenhang mit ADO Eigenschaften und Methoden stehen. Betrachten Sie die folgenden Befehle, die Eigenschaften des Recordset Objektes auf bestimmte Werte setzen:

objRecordset.CursorLocation = adUseClient
objRecordset.LockType = adLockBatchOptimistic
objRecordset.CursorType = adOpenStatic

Die Variablen adUseClient, adLockBatchOptimistic und adOpenStatic sind ADO Konstanten. Sie werden im obigen Beispiel benutzt, um die Recordset Eigenschaften auf bestimmte Werte zu setzen. Dadurch wird zum Beispiel der Funktionsumfang des Recordset wunschgemäß eingestellt.

Jede der ADO Konstanten steht für einen numerischen Wert. Zum Beispiel liefert adUseClient einfach den Wert 3. Das obige Beispiel ist daher identisch mit folgendem:

objRecordset.CursorLocation = 3
objRecordset.LockType = 4
objRecordset.CursorType = 3

Nun ist es nicht sonderlich praktisch, wenn man beim Entwickeln einer ASP Datenbank Applikation einfach Zahlen statt den aussagekräftigen ADO Konstanten benutzt.

Ein Beispiel: Mit der Konstante adUseClient definiert man den ADO Cursor als client-seitig. Das bedeutet, der Recordset Cursor wird vom Webserver verwaltet und nicht von der Datenbank. Wenn sie beim Programmieren die Konstante adUseClient in eine ASP Seite schreiben, so wissen Sie, wofür diese steht. Hingegen ist ein Wert wie "3" nicht wirklich leicht zu deuten. Steht er nun für adUseClient oder adUseServer?

Damit nicht nur Sie wissen, wofür eine ADO Konstante wie adUseClient steht, sondern auch Ihr ASP Skript (VBScript) versteht, daß mit der Konstante adUseClient eigentlich der Wert 3 gemeint ist, müssen Sie die ADO Konstanten definieren. VBScript selbst hat keine ADO Konstanten definiert.

Definieren von ADO Konstanten

Sie können die ADO Konstanten, die Sie in Ihrer ASP Seite benötigen, mit dem VBScript Befehl Const definieren:

Const adUseClient = 3
Const adUseServer = 2

Const adOpenDynamic = 2
Const adOpenForwardOnly = 0
Const adOpenKeyset = 1
Const adOpenStatic = 3

objRecordset.CursorLocation = adUseClient
objRecordset.CursorType = adOpenStatic

Sie müssen diese Werte nicht aus der Dokumentation zusammensuchen, da ADO die Datei Adovbs.inc (für VBScript) bereitstellt, die alle ADO Konstanten enthält.

Adovbs.inc als Include-Datei

Eleganter als das Kopieren der Werte aus der Datei Adovbs.inc ist folgende Methode:

1. Kopieren Sie die Datei Adovbs.inc in das Home-Directory Ihrer ASP Website.
2. Fügen Sie in allen ASP Seiten, die ADO Konstanten benutzen, den folgenden Befehl ein:
   

   <!--#include virtual="/Adovbs.inc"-->

3. Durch diesen Befehl können Sie alle ADO-Konstanten in der ASP-Seite benutzen.

Der #include-Befehl muss ausserhalb der ASP Delimiter (<% %>) stehen. Der Befehl selbst stellt ein sogenanntes Server-Side-Include (SSI) dar. Es bewirkt, daß alles, was in der Datei Adovbs.inc steht, beim Ausführen an der Stelle des #include-Befehles in die ASP Seite eingefügt wird.

Wo findet man die Datei Adovbs.inc?

Wenn Sie ADO auf einem Computer installiert haben, und das ist schon bei Internet Explorer 5.01 der Fall, so finden Sie die Datei Adovbs.inc im Verzeichnis C:\Programme\Gemeinsame Dateien\System\Ado (deutsche ADO Installation), oder in C:\Program Files\Common Files\System\ADO (englische Version). C:\ steht dabei für das Laufwerk, auf dem das Betriebssystem installiert ist.

Die Datei Adovbs.inc ist integraler Bestandteil der ADO Core Components. Es ist somit in jeder ADO und MDAC Installation vorhanden. Da ADO Bestandteil aufgrund seiner Bedeutung bereits Bestandteil vieler Software packete ist, befindet sich die Datei auf dem Computer, sobald man zum Beispiel Internet Explorer (ab Version 4.01), Personal Web Server (PWS), Internet Information Server (IIS), MDAC (Microsoft Data Access Components) oder Windows 98 SE installiert hat.

ADO Konstanten unter JScript

Abschließendes Beispiel

Zum Abschluss noch ein Beispiel, wie der Begin einer ASP-Seite mit inkludierter Adovbs.inc Datei aussehen könnte:

<% @ LANGUAGE="VBScript" ENABLESESSIONSTATE=False %>
<% Option Explicit %>
<!--#include virtual="/Adovbs.inc"-->

<%
strTitle = "ADO Konstanten und die Datei Adovbs.inc"
 %>
<HTML>
<HEAD>
   <TITLE><%= strT%></TITLE>
</HEAD>
<BODY>
...

Verwandte Artikel

ADO und ASP - Datenbanken einmal näher betrachtet
ADO und MDAC Versionen
Benutzerverwaltung leicht gemacht: Teil 1
Eigenschaften der Connection und Recordset Objekte
Ein einfacher Eventkalender für Projektteams
Highspeed-Abfragen einer SQL Server Datenbank
Installation der neuesten ADO Version (ADO 2.5)

Links zu anderen Sites

ASP Typenbibliotheken in Active Server Pages
Bibliotheken mit ADO-Komponenten

Wenn Sie jetzt Fragen haben...

Wenn Sie Fragen rund um die in diesem Artikel vorgestellte Technologie haben, dann schauen Sie einfach bei uns in den Community Foren der deutschen .NET Community vorbei. Die Teilnehmer helfen Ihnen gerne, wenn Sie sich zur im Artikel vorgestellten Technologie weiterbilden möchten.

Haben Sie Fragen die sich direkt auf den Inhalt des Artikels beziehen, dann schreiben Sie dem Autor! Unsere Autoren freuen sich über Feedback zu ihren Artikeln. Ein einfacher Klick auf die Autor kontaktieren Schaltfläche (weiter unten) und schon haben Sie ein für diesen Artikel personalisiertes Anfrageformular.

Und zu guter Letzt möchten wir Sie bitten, den Artikel zu bewerten. Damit helfen Sie uns, die Qualität der Artikel zu verbessern - und anderen Lesern bei der Auswahl der Artikel, die sie lesen sollten.