ASP -Kurzreferenz


ASP-Kurzreferenz aus dem Beispiel-Tutorial. Drucken Sie sie aus und behalten Sie sie für den jederzeitigen Gebrauch griffbereit.


Grundlegende Syntax

ASP-Skripte werden von <% und %> umschlossen. So schreiben Sie eine Ausgabe an den Browser:

<html>
<body>
<% response.write("Hello World!") %>
</body>
</html>

Die Standardsprache in ASP ist VBScript. Um eine andere Skriptsprache zu verwenden, fügen Sie oben auf der ASP-Seite eine Sprachdeklaration ein:

<%@ language="javascript" %>
<html>
<body>

<%
....
%>

Formulare und Benutzereingaben

Request.QueryString wird verwendet, um Werte aus einem Formular mit method="get" abzurufen. Informationen, die von einem Formular mit der GET-Methode gesendet werden, sind für alle Benutzer sichtbar (sie erscheinen in der Adressleiste des Browsers) und unterliegen Mengenbeschränkungen bezüglich der sendbaren Daten.

Request.Form wird verwendet, um Werte aus einem Formular mit method="post" abzurufen. Informationen, die über die POST-Methode von einem Formular gesendet werden, sind für Benutzer unsichtbar und unterliegen keinen Beschränkungen hinsichtlich der Datenmenge.

ASP Cookies

Cookies werden häufig verwendet, um Benutzer zu identifizieren. Ein Cookie ist eine kleine Datei, die der Server auf dem Computer des Benutzers ablegt. Wann immer derselbe Computer über einen Browser eine Seite anfordert, sendet er das Cookie mit.

Der Befehl Response.Cookies wird zum Erstellen eines Cookies verwendet:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2002"
%>

Hinweis:Der Befehl Response.Cookies muss vor dem <html>-Tag stehen!

Der Befehl "Request.Cookies" wird verwendet, um den Cookie-Wert abzurufen:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Dateien einbinden

Durch die Verwendung der #include-Direktive können Sie den Inhalt einer anderen ASP-Datei in eine ASP-Datei einfügen, bevor der Server diese ausführt. Die #include-Direktive wird verwendet, um Funktionen, Header, Footer oder andere Elemente zu erstellen, die auf mehreren Seiten wiederverwendet werden müssen.

Syntax:

<!--#include virtual="somefile.inc"-->
Oder
<!--#include file ="somefile.inc"-->

Verwenden Sie das Schlüsselwort virtual, um einen Pfad anzugeben, der mit einem virtuellen Verzeichnis beginnt. Wenn sich eine Datei namens "header.inc" im virtuellen Verzeichnis /html befindet, fügt die folgende Codezeile den Inhalt der Datei "header.inc" ein:

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

Verwenden Sie das Schlüsselwort file, um einen relativen Pfad anzugeben. Ein relativer Pfad beginnt mit dem Verzeichnis, das die verweisende Datei enthält. Wenn Sie eine Datei im html-Verzeichnis haben und sich die Datei "header.inc" ebenfalls im html-Verzeichnis befindet, fügt die folgende Codezeile den Inhalt der Datei "header.inc" in Ihre Datei ein:

<!-- #include file ="headersheader.inc" -->

Verwenden Sie das Schlüsselwort file mit der Syntax (..), um auf eine Datei in einem übergeordneten Verzeichnis zu verweisen.

Global.asa

Die Datei Global.asa ist eine optionale Datei, die Deklarationen von Objekten, Variablen und Methoden enthalten kann, auf die von jeder Seite in einer ASP-Anwendung zugegriffen werden kann.

Hinweis:Die Datei Global.asa muss im Stammverzeichnis der ASP-Anwendung gespeichert werden, und jede Anwendung kann nur eine Global.asa-Datei haben.

Die Datei Global.asa kann nur Folgendes enthalten:

  • Anwendungsereignisse
  • Sitzungsereignisse
  • <object>-Deklarationen
  • Typbibliothek-Deklarationen
  • #include-Direktive

Anwendungs- und Sitzungsereignisse

In Global.asa können Sie den Anwendungs- und Sitzungsobjekten mitteilen, was beim Start und beim Ende der Anwendung bzw. der Sitzung geschehen soll. Der Code, der diese Aufgabe erfüllt, wird in Ereignishandlern platziert.Hinweis:Da wir keine ASP-Skriptbegrenzer (<% und %>) verwenden können, um Skripte in die Global.asa-Datei einzufügen, müssen wir die Unterprogramme innerhalb von HTML-<script>-Tags platzieren:

<script language="vbscript" runat="server">
sub Application_OnStart
' some code
end sub
sub Application_OnEnd
' some code
end sub
sub Session_OnStart
' some code
end sub
sub Session_OnEnd
' some code
end sub
</script>

<object>-Deklarationen

Objekte mit Sitzungs- oder AnwendungssGültigkeitsbereich können in der Global.asa-Datei mithilfe des <object>-Tags erstellt werden.Hinweis:Das <object>-Tag sollte außerhalb des <script>-Tags platziert werden!

Syntax:

<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>

TypeLibrary-Deklaration

Eine Typbibliothek (TypeLibrary) ist ein Container, der DLL-Dateien enthält, die COM-Objekten entsprechen. Durch das Einbinden eines Aufrufs der Typbibliothek in die Global.asa-Datei können Sie auf die Konstanten von COM-Objekten zugreifen, und ASP-Code kann Fehler außerdem besser melden. Wenn Ihre Webanwendung von COM-Objekten abhängt, deren Datentypen bereits in einer Typbibliothek deklariert sind, können Sie die Typbibliothek in Global.asa deklarieren.

Syntax:

<!--METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->

Session-Objekt

Das Session-Objekt wird verwendet, um Informationen über eine Benutzersitzung zu speichern oder Einstellungen der Benutzersitzung zu ändern. Variablen, die im Session-Objekt gespeichert sind, speichern Informationen über einen einzelnen Benutzer und stehen allen Seiten in einer Anwendung zur Verfügung.

Auflistungen

  • Contents - Enthält alle Elemente, die über Skriptbefehle zur Sitzung hinzugefügt wurden.
  • StaticObjects - Enthält alle Objekte, die mithilfe des HTML-<object>-Tags zur Sitzung hinzugefügt wurden.
  • Contents.Remove(item/index) – Entfernt ein Element aus der Contents-Sammlung.
  • Contents.RemoveAll() – Entfernt alle Elemente aus der Contents-Sammlung.

Eigenschaften

  • CodePage – Legt den Zeichensatz fest, der beim Anzeigen dynamischer Inhalte verwendet wird.
  • LCID – Legt den Gebietsschemabezeichner (Locale Identifier) fest, der zum Anzeigen dynamischer Inhalte verwendet wird.
  • SessionID – Gibt die Sitzungs-ID zurück.
  • Timeout – Legt den Zeitüberschreitungszeitraum für die Sitzung fest oder gibt ihn zurück.

Methoden

  • Abandon – Zerstört alle Objekte im Session-Objekt.

Application-Objekt

Eine Gruppe von ASP-Dateien, die zusammenarbeiten, um eine Aufgabe auszuführen, wird als Anwendung bezeichnet. Das Application-Objekt wird verwendet, um diese Dateien miteinander zu verknüpfen. Alle Benutzer teilen sich ein einziges Application-Objekt. Das Application-Objekt speichert Informationen, die von vielen Seiten in einer Anwendung verwendet werden (wie z. B. Datenbankverbindungsinformationen).

Auflistungen

  • Contents – Enthält alle Elemente, die über Skriptbefehle zur Anwendung hinzugefügt wurden.
  • StaticObjects – Enthält alle Objekte, die der Anwendung über das HTML-Tag <object> hinzugefügt wurden.
  • Contents.Remove – Entfernt ein Element aus der Contents-Sammlung.
  • Contents.RemoveAll – Entfernt alle Elemente aus der Contents-Sammlung.

Methoden

  • Lock – Verhindert, dass Benutzer Eigenschaften im Application-Objekt ändern.
  • Unlock – Ermöglicht Benutzern das Ändern von Eigenschaften im Application-Objekt.

Response-Objekt

Das Response-Objekt wird verwendet, um Ausgaben vom Server an den Benutzer zu senden.

Auflistungen

  • Cookies(name) – Legt den Wert eines Cookies fest. Wenn das Cookie nicht existiert, wird es erstellt und der angegebene Wert wird zugewiesen.

Eigenschaften

  • Buffer – Gibt an, ob die Ausgabe gepuffert werden soll. Wenn die Ausgabe gepuffert ist, blockiert der Server die Antwort an den Browser, bis alle Serverskripte verarbeitet wurden oder bis das Skript die Methode Flush oder End aufruft. Wenn Sie diese Eigenschaft festlegen möchten, sollte sie vor dem <html>-Tag in der ASP-Datei platziert werden.
  • CacheControl – Legt fest, ob Proxyserver die von ASP generierte Ausgabe zwischenspeichern können. Wenn dies auf Public eingestellt ist, speichern Proxyserver die Seite zwischen.
  • Charset(charset_name) – Hängt den Namen des Zeichensatzes (wie "ISO8859-1") an den Content-Type-Header im Response-Objekt an.
  • ContentType – Legt den HTTP-Inhaltstyp des Response-Objekts fest (wie "text/html", "image/gif", "image/jpeg", "text/plain"). Der Standardwert ist "text/html".
  • Expires – Legt die Browser-Cache-Zeit (in Minuten) fest, bevor die Seite abläuft.
  • ExpiresAbsolute – Legt das Datum und die Uhrzeit fest, zu denen die im Browser zwischengespeicherte Seite abläuft.
  • IsClientConnected – Zeigt an, ob die Verbindung des Clients zum Server getrennt wurde.
  • Pics(pics_label) – Hängt einen Wert an das PICS-Tag im Antwortheader an.
  • Status – Gibt den Wert der vom Server zurückgegebenen Statuszeile an.

Methoden

  • AddHeader(name, value) – Fügt der HTTP-Antwort einen neuen HTTP-Header und einen Wert hinzu.
  • AppendToLog string – Hängt eine Zeichenfolge an das Ende des Serverprotokolleintrags an.
  • BinaryWrite(data_to_write) – Schreibt Daten ohne Zeichenkonvertierung direkt in die Ausgabe.
  • Clear – Löscht die gepufferte Ausgabe. Verwenden Sie diese Methode, um Fehler zu behandeln. Wenn Response.Buffer nicht auf true gesetzt ist, führt diese Methode zu einem Laufzeitfehler.
  • End – Beendet die Verarbeitung des Skripts und gibt das aktuelle Ergebnis zurück.
  • Flush – Sendet die gepufferte Ausgabe sofort. Wenn Response.Buffer nicht auf true gesetzt ist, führt diese Methode zu einem Laufzeitfehler.
  • Redirect(url) – Leitet den Benutzer zu einer anderen URL weiter.
  • Write(data_to_write) – Schreibt Text für den Benutzer.

Request-Objekt

Wenn der Browser eine Seite vom Server anfordert, wird dieses Verhalten als Anfrage (Request) bezeichnet. Das Request-Objekt wird verwendet, um Informationen vom Benutzer abzurufen.

Auflistungen

  • ClientCertificate – Enthält alle im Clientzertifikat gespeicherten Feldwerte.
  • Cookies(name) – Enthält alle in der HTTP-Anfrage gesendeten Cookie-Werte.
  • Form(element_name) – Enthält alle Formularwerte (Eingaben), die von einem Formular mit der POST-Methode gesendet wurden.
  • QueryString(variable_name) – Enthält alle Variablenwerte in der HTTP-Abfragezeichenfolge.
  • ServerVariables(server_variable) – Enthält alle Servervariablenwerte.

Eigenschaften

  • TotalBytes – Gibt die Gesamtzahl der Bytes zurück, die vom Client im Anfragetext gesendet wurden.

Methoden

  • BinaryRead – Ruft Daten ab, die im Rahmen einer POST-Anfrage vom Client an den Server gesendet wurden.

Server-Objekt

Das Server-Objekt wird verwendet, um auf Eigenschaften und Methoden auf dem Server zuzugreifen.

Eigenschaften

  • ScriptTimeout – Legt die maximale Zeit in Sekunden fest, die ein Skript ausgeführt werden kann, bevor es beendet wird, oder gibt diese zurück.

Methoden

  • CreateObject(type_of_object) – Erstellt eine Instanz eines Objekts.
  • Execute(path) – Führt eine andere ASP-Datei von innerhalb einer ASP-Datei aus. Nachdem die aufgerufene ASP-Datei die Ausführung beendet hat, kehrt die Steuerung zur ursprünglichen ASP-Datei zurück.
  • GetLastError() – Gibt ein ASPError-Objekt zurück, das die aufgetretene Fehlersituation beschreibt.
  • HTMLEncode(string) – Wendet HTML-Kodierung auf eine Zeichenfolge an.
  • MapPath(path) – Bildet einen relativen oder virtuellen Pfad auf einen physischen Pfad ab.
  • Transfer(path) – Sendet alle Zustandsinformationen zur Verarbeitung an eine andere Datei. Nach der Übertragung kehrt die Programmkontrolle nicht zur ursprünglichen ASP-Datei zurück.
  • URLEncode(string) – Wendet URL-Kodierungsregeln auf eine Zeichenfolge an.
Andere Erweiterungen