ASP-Spezifikation verwenden

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Active-Server-Seiten erstellen - Übersicht


Die ASP-Spezifikation besteht aus einer Reihe von COM-Objekten, die ASP den Objekten zur Verfügung stellt, die auf der Active-Server-Seite ausgeführt werden. Diese ermöglichen Ihrem Active-Server-Objekt den Zugriff auf Informationen über die Botschaften, die zwischen der Anwendung und dem Web-Browser ausgetauscht werden, sowie einen Ort zum Speichern von Informationen, die von Active-Server-Objekten, die derselben Anwendung angehören, gemeinsam benutzt werden.

Um einen einfachen Zugriff auf diese Informationen zu ermöglichen, legt die Basisklasse für Ihr Active-Server-Objekt diese als Eigenschaften offen. Vollständige Informationen zu diesen Objekten finden Sie in der entsprechenden Dokumentation von Microsoft. Die nachfolgenden Themen geben Ihnen jedoch einen kurzen Überblick.


Application

Der Zugriff auf das Application-Objekt erfolgt über eine IApplicationObject-Schnittstelle. Sie repräsentiert eine vollständige ASP-Anwendung, die als eine Reihe von .ASP-Dateien in einem virtuellen Verzeichnis und seinen Unterverzeichnissen definiert ist. Da das Application-Objekt von mehreren Clients gemeinsam genutzt werden kann, enthält es eine Sperrfunktion, die Sie zur Vermeidung von Thread-Konflikten verwenden sollten.

IApplicationObject enthält die folgenden Elemente:

Elemente der Schnittstelle IApplicationObject:

Eigenschaft, Methode oder Ereignis Beschreibung

Contents (Eigenschaft)

Enthält eine Liste aller Befehle, die der Anwendung mit Skript-Befehlen hinzugefügt wurden. Die Schnittstelle verfügt über zwei Methoden: Remove und RemoveAll, die Sie zum Löschen eines oder aller Objekte aus der Liste verwenden können.

StaticObjects (Eigenschaft)

Enthält eine Liste aller Befehle, die der Anwendung mit <OBJECT>-Tag hinzugefügt wurden.

Lock (Methode)

Hindert andere Clients am Sperren des Application-Objekts, bis Sie Unlock aufrufen. Alle Clients sollten vor dem Zugriff auf gemeinsam genutzten Speicher (z.B. die Eigenschaften) Lock aufrufen.

Unlock (Methode)

Hebt die Sperre auf, die mit der Methode Lock gesetzt wurde.

Application_OnEnd (Ereignis)

Tritt bei Beenden der Anwendung nach dem Ereignis Session_OnEnd auf. Die einzig verfügbaren Spezifikationen sind Application und Server. Die Ereignisbehandlung muss in VBScript oder JScript geschrieben sein.

Application_OnStart (Ereignis)

Tritt vor dem Erstellen der neuen Sitzung auf (vor Session_OnStart). Die einzig verfügbaren Spezifikationen sind Application und Server. Die Ereignisbehandlung muss in VBScript oder JScript geschrieben sein.


Request

Der Zugriff auf das Request-Objekt erfolgt über eine IRequest-Schnittstelle. Sie liefert Informationen über die HTTP-Anforderungsbotschaft, die das Öffnen der Active-Server-Seite verursachte.

IRequest enthält die folgenden Elemente:

Elemente der Schnittstelle IRequest:

Eigenschaft, Methode oder Ereignis Beschreibung

ClientCertificate (Eigenschaft)

Gibt den Wert aller Felder im Clientzertifikat an, das mit der HTTP-Botschaft gesendet wird.

Cookies (Eigenschaft)

Gibt die Werte aller Cookie-Header in der HTTP-Botschaft an.

Form (Eigenschaft)

Gibt die Werte aller Formularelemente im HTTP-Body an. Auf diese Weise kann über den Namen zugegriffen werden.

QueryString (Eigenschaft)

Gibt die Werte aller Variablen im Abfrage-String aus dem HTTP-Header an.

ServerVariables (Eigenschaft)

Gibt die Werte der unterschiedlichen Umgebungsvariablen an. Diese repräsentieren die häufigsten HTTP-Header-Variablen.

TotalBytes (Eigenschaft)

Gibt die Anzahl der Byte im Anforderungsteil an. Dies ist die Obergrenze für die Anzahl der Byte, die von der Methode BinaryRead zurückgegeben werden.

BinaryRead (Methode)

Ruft den Inhalt einer Post-Botschaft ab. Rufen Sie die Methode auf, wobei Sie die maximale Anzahl der zu lesenden Byte angeben. Der sich ergebende Inhalt wird als varianter Array aus Byte zurückgegeben. Nach Aufruf von BinaryRead können Sie die Eigenschaft Form nicht verwenden.


Response

Der Zugriff auf das Response-Objekt erfolgt über eine IResponse-Schnittstelle. Es ermöglicht die Angabe von Informationen über die HTTP-Antwortbotschaft, die an den Client-Browser zurückgegeben wird.

IResponse enthält die folgenden Elemente:

Elemente der Schnittstelle IResponse:

Eigenschaft, Methode oder Ereignis Beschreibung

Cookies (Eigenschaft)

Bestimmt die Werte aller Cookie-Header in der HTTP-Botschaft.

Buffer (Eigenschaft)

Gibt an, ob die Seitenausgabe gepuffert wird. Wenn dies der Fall ist, sendet der Server solange keine Antwort an den Client, bis alle Server-Skripts auf der aktuellen Seite verarbeitet sind.

CacheControl (Eigenschaft)

Legt fest, ob Proxy-Server die Ausgabe in der Antwort zwischenspeichern können.

Charset (Eigenschaft)

Fügt dem Inhaltstyp-Header den Namen des Zeichensatzes hinzu.

ContentType (Eigenschaft)

Gibt den HTTP-Inhaltstyp des Bodys der Antwortbotschaft zurück.

Expires (Eigenschaft)

Gibt an, wie lange die Antwort von einem Browser zwischengespeichert werden kann, bis sie abläuft.

ExpiresAbsolute (Eigenschaft)

Gibt an, zu welchem Datum und zu welcher Uhrzeit die Antwort abläuft.

IsClientConnected (Eigenschaft)

Gibt an, ob der Client vom Server getrennt wurde.

Pics (Eigenschaft)

Legt den Wert für das Feld pics-label des Antwort-Headers fest.

Status (Eigenschaft)

Gibt den Status der Antwort an. Dies ist der Wert eines HTTP-Status-Headers.

AddHeader (Methode)

Fügt einen HTTP-Header mit einem bestimmten Namen und Wert hinzu.

AppendToLog (Methode)

Fügt dem Ende des Web-Server-Protokolleintrags für diese Anforderung einen String hinzu.

BinaryWrite (Methode)

Schreibt Raw-Informationen (uninterpretiert) in den Body der Antwortbotschaft.

Clear (Methode)

Löscht die gesamte gepufferte HTML-Ausgabe.

End (Methode)

Stoppt die Verarbeitung der .ASP-Datei und gibt das aktuelle Ergebnis zurück.

Flush (Methode)

Sendet die gesamte gepufferte Ausgabe sofort.

Redirect (Methode)

Sendet eine redirect-Antwortbotschaft, wobei der Client-Browser an einen unterschiedlichen URL weitergeleitet wird.

Write (Methode)

Schreibt eine Variable an die aktuelle HTTP-Ausgabe als einen String.


Session

Der Zugriff auf das Session-Objekt erfolgt über eine ISessionObject-Schnittstelle. Es ermöglicht Ihnen die Speicherung von Variablen, die für die Dauer der Interaktion eines Clients mit der ASP-Anwendung persistent sein sollen. Konkret bedeutet dies, dass die Variablen nicht freigegeben werden, wenn der Client die einzelnen Seiten einer ASP-Anwendung öffnet, sondern nur, wenn der Client die Anwendung ganz verlässt.

ISessionObject enthält die folgenden Elemente:

Elemente der Schnittstelle ISessionObject:

Eigenschaft, Methode oder Ereignis Beschreibung

Contents (Eigenschaft)

Enthält eine Liste aller Befehle, die der Sitzung mit <OBJECT>-Tag hinzugefügt wurden. Sie können auf die Variablen in der Liste dem Namen nach zugreifen, oder die Methoden Remove oder RemoveAll des Contents-Objekts aufrufen, um Werte zu löschen.

StaticObjects (Eigenschaft)

Enthält eine Liste aller Befehle, die der Sitzung mit <OBJECT>-Tag hinzugefügt wurden.

CodePage (Eigenschaft)

Gibt die Code-Seite an, die für die Symbolzuweisung verwendet werden soll. Unterschiedliche Länderkennungen verwenden eventuell verschiedene Code-Seiten.

LCID (Eigenschaft)

Gibt die ID der Länderkennung an, mit der String-Inhalte interpretiert werden.

SessionID (Eigenschaft)

Gibt die Sitzungs-ID für den aktuellen Client an.

TimeOut (Eigenschaft)

Gibt an, wie viele Minuten die Sitzung ohne eine Anforderung (oder Aktualisierung) vom Client andauert, bis die Anwendung beendet wird.

Abandon (Methode)

Zerstört die Sitzung und gibt ihre Ressourcen frei.

Session_OnEnd (Ereignis)

Tritt bei einem Abbruch oder einer Zeitüberschreitung der Sitzung auf. Die einzig verfügbaren Spezifikationen sind Application, Server und Sitzung. Die Ereignisbehandlung muss in VBScript oder JScript geschrieben sein.

Session_OnStart (Ereignis)

Tritt nach Erstellung einer neuen Sitzung auf (nach Application_OnStart, jedoch vor Ausführung des Skripts auf der Active-Server-Seite). Alle Spezifikationen stehen zur Verfügung. Die Ereignisbehandlung muss in VBScript oder JScript geschrieben sein.


Server

Der Zugriff auf das Server-Objekt erfolgt über eine IServer-Schnittstelle. Es bietet verschiedene Utilities zum Schreiben Ihrer ASP-Anwendung.

IServer enthält die folgenden Elemente:

Elemente der Schnittstelle IServer:

Eigenschaft, Methode oder Ereignis Beschreibung

ScriptTimeOut (Eigenschaft)

Entspricht der Eigenschaft TimeOut des Session-Objekts.

CreateObject (Methode)

Instantiiert ein bestimmtes Active-Server-Objekt.

Execute (Methode)

Führt das Skript in einer bestimmten .ASP-Datei aus.

GetLastError (Methode)

Gibt ein ASPError-Objekt mit einer Beschreibung der Fehlerbedingung zurück.

HTMLEncode (Methode)

Codiert einen String für die Verwendung in einem HTML-Header, wobei reservierte Zeichen von den entsprechenden symbolischen Konstanten ersetzt werden.

MapPath (Methode)

Ordnet einen bestimmten virtuellen Pfad (ein absoluter Pfad auf dem aktuellen Server oder ein relativer Pfad der aktuellen Seite) einem physischen Pfad zu.

Transfer (Methode)

Sendet alle aktuellen Statusinformationen an eine andere Active-Server-Seite zur Verarbeitung.

URLEncode (Methode)

Wendet URL-Codierungsregeln, einschließlich Escape-Zeichen, einem bestimmten String zu.


Siehe auch