ASP-Schnellreferenz

ASP-Schnellreferenz von CodeW3C.com. Drucken Sie sie aus, stecken Sie sie in die Tasche und verwenden Sie sie jederzeit.

Grundlagen Syntax

ASP-Skript wird von <% und %> umgeben. Auf diese Weise wird dem Browser Inhalt ausgegeben:

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

Die Standard-Sprache in ASP ist VBScript. Wenn eine andere Skriptsprache verwendet werden soll, wird eine Sprachdeklaration am Anfang der ASP-Seite eingefügt:

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

Formulare und Benutzer-Eingaben

Request.QueryString wird verwendet, um Werte aus Formularen mit method="get" zu sammeln. Informationen, die über GET von einem Formular gesendet werden, sind für alle sichtbar (werden im Browser-Adressfeld angezeigt) und haben eine Beschränkung in Bezug auf die Datenmenge.

Request.Form wird verwendet, um Werte aus Formularen mit method="post" zu sammeln. Informationen, die über POST von einem Formular gesendet werden, sind für andere nicht sichtbar und haben keine Beschränkung in Bezug auf die Datenmenge.

ASP-Cookies

Cookies werden häufig verwendet, um Benutzer zu identifizieren. Ein Cookie ist eine kleine Datei, die vom Server in den Computer des Benutzers eingefügt wird. Jedes Mal, wenn das gleiche Computer über einen Browser eine Seite anfordert, wird auch das Cookie gesendet.

Der Befehl Response.Cookies wird verwendet, um Cookies zu erstellen:

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

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

"Request.Cookies"-Befehl wird verwendet, um Cookie-Werte abzurufen:

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

Datei-Verweis

Mit dem #include-Befehl können Sie den Inhalt einer ASP-Datei vor der Ausführung auf dem Server in eine andere ASP-Datei einfügen. Der #include-Befehl wird verwendet, um Funktionen, Header, Footer oder Elemente zu erstellen, die auf mehreren Seiten wiederverwendet werden.

Syntax:

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

oder

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

Verwenden Sie das Stichwort virtual, um Pfade zu indizieren, die mit einem virtuellen Verzeichnis beginnen. Wenn die Datei "header.inc" sich im virtuellen Verzeichnis /html befindet, wird der folgende Code den Inhalt von "header.inc" einfügen:

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

Verwenden Sie das Schlüsselwort 'file', um relative Pfade anzuzeigen. Der relative Pfad beginnt mit dem Verzeichnis, das die referenzierte Datei enthält. Wenn Ihre Datei im Verzeichnis html liegt und die Datei "header.inc" im html\headers-Verzeichnis liegt, wird der folgende Code den Inhalt von "header.inc" in Ihre Datei einfügen:

<!-- #include file ="headers\header.inc" -->

Verwenden Sie den Schlüsselwort 'file' und die Syntax (..\) zur Referenzierung von Dateien in höheren Verzeichnissen.

Global.asa

Die Datei Global.asa ist eine optionale Datei und kann Objektdeklarationen, Variablen und Methoden enthalten, die von jeder Seite der ASP-Anwendung aufgerufen werden können.

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

Die Datei Global.asa kann nur das Folgende enthalten:

  • Application-Ereignisse
  • Session-Ereignisse
  • <object>-Deklaration
  • TypeLibrary-Deklaration
  • #include-Anweisung

Application- und Session-Ereignisse

In der Global.asa können Sie angeben, was die application- und session-Objekte tun sollen, wenn die application/session beginnt und endet. Der Code für diese Aufgaben befindet sich in den Ereignisbehandlern.

Kommentar: Wenn Sie Code in der Global.asa-Datei einfügen, verwenden wir nicht <% und %>, sondern platzieren Subroutinen im HTML <script>-Tag:

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

<object>-Deklaration

Durch die Verwendung des <object>-Tags können Sie auch im Global.asa Objekte mit Session- oder Application-Scope erstellen.

Kommentar: Der <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

TypeLibrary ist ein Inhaltcontainer für DLL-Dateien, die mit COM-Objekten korrespondieren. Durch das Einbinden von Aufrufen auf die TypeLibrary in der Global.asa-Datei können die Konstanten der COM-Objekte aufgerufen werden, und das ASP-Code kann besser Fehler melden. Wenn Ihre Web-Anwendung von COM-Objekten abhängt, die in der Typelibrary deklariert wurden, können Sie diese Typelibrary in der 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 die Benutzer-Session zu speichern oder deren Einstellungen zu ändern. Die Variablen im Session-Objekt enthalten Informationen über einen einzelnen Benutzer und können von allen Seiten einer Anwendung aufgerufen werden.

Sammlung

  • Contents - Enthält alle Einträge, die durch Skriptbefehle in die Session hinzugefügt wurden
  • StaticObjects - Enthält alle Objekte, die durch die <object>-Tag in HTML hinzugefügt wurden
  • Contents.Remove(item/index) - Entfernt ein Element aus dem Contents-Set
  • Contents.RemoveAll() - Entfernt alle Elemente aus dem Contents-Set

Eigenschaft

  • CodePage - Bestimmt den Zeichensatz, der zur Anzeige dynamischer Inhalte verwendet wird
  • LCID - Setzt den Regionaleinstellungs-Identifikator für die Anzeige dynamischer Inhalte
  • SessionID - Gibt die Session-ID zurück
  • Timeout - Setzt oder gibt die Ablaufzeit der Session zurück

Methode

  • Abandon - Entfernt alle Objekte im session-Objekt.

Application-Objekt

Eine Gruppe von ASP-Dateien, die zusammenarbeiten, um eine Aufgabe zu erledigen, wird als Anwendung bezeichnet. Das Application-Objekt in ASP wird verwendet, um diese Dateien zusammenzuführen. Alle Benutzer teilen sich ein Application-Objekt. Das Application-Objekt sollte Informationen enthalten, die von vielen Seiten der Anwendung verwendet werden (z.B. Datenbankverbindungsinformationen).

Sammlung

  • Inhalte - Enthält alle Elemente, die durch Skriptbefehle in die Anwendung hinzugefügt wurden
  • StaticObjects - 包含所有使用 HTML 的 <object> 标签追加到应用程序中的对象
  • Contents.Remove - 从 Contents 集合中删除一个项目
  • Contents.RemoveAll - 从 Contents 集合中删除所有的项目

Methode

  • Lock - 防止用户修改 Application 对象中的变量
  • Unlock - 允许用户修改 Application 对象中的变量

Response 对象

Response 对象用于从服务器将输出发送给用户。

Sammlung

Cookies(name) - 设置 cookie 的值。如果不存在，就创建 cookie ，然后设置指定的值。

Eigenschaft

  • Buffer - 定义是否缓冲输出。当输出设置为缓存时，服务器会阻止向浏览器的响应，直到所有的服务器脚本都被处理，或者直到脚本调用了 Flush 或 End 方法。如果要设置此属性，它应当位于 .asp 文件中的 <html> 标签之前。
  • CacheControl - 设置代理服务器是否可以缓存由 ASP 生成的输出。如果设置为 Public，则代理服务器会缓存页面。
  • Charset(charset_name) - 将字符集的名称追加到 Response 对象中的 content-type 报头。
  • ContentType - 设置 Response 对象的 HTTP 内容类型。（例如 "text/html", "image/gif", "image/jpeg", "text/plain"）。默认是 "text/html"
  • Expires - 设置页面在失效前的浏览器缓存时间（分钟）
  • ExpiresAbsolute - 设置浏览器上页面缓存失效的日期和时间
  • IsClientConnected - 指示客户端是否已从服务器断开
  • Pics(pics_label) - 向 response 报头的 PICS 标志追加值
  • Status - 定义由服务器返回的状态行的值

Methode

  • AddHeader(name, value) - 向 HTTP 响应添加新的 HTTP 报头和值
  • AppendToLog string - 字符串添加到服务器的项目（server log entry）末尾
  • BinaryWrite(data_to_write) - Schreibt Daten direkt an die Ausgabe ohne jegliche Zeichenkonvertierung
  • Clear - Entfernt den bereits gespeicherten Output. Verwenden Sie diesen Methode, um Fehler zu behandeln. Wenn Response.Buffer nicht auf true gesetzt ist, führt dieser Methode eine Laufzeitfehler aus
  • End - Stoppt die Verarbeitung des Skripts und gibt das aktuelle Ergebnis zurück
  • Flush - Sendet sofort den gespeicherten Output. Wenn Response.Buffer nicht auf true gesetzt ist, führt dieser Methode eine Laufzeitfehler aus
  • Redirect(url) - Leit den Benutzer zu einer anderen URL um
  • Write(data_to_write) - Schreibt Text an den Benutzer

Request-Objekt

Wenn der Browser eine Seite von einem Server anfordert, wird dies als request bezeichnet. Der request-Objekt wird verwendet, um Informationen vom Benutzer zu erhalten.

Sammlung

  • ClientCertificate - Enthält die Werte der Felder, die im Kundenzertifikat gespeichert sind
  • Cookies(name) - Enthält die Werte der Cookies
  • Form(element_name) - Enthält die Werte der Formularfelder. Dieses Formular muss die POST-Methode verwenden
  • QueryString(variable_name) - Enthält die Werte der Variablen in der Abfragezeichenkette
  • ServerVariables(server_variable) - Enthält den Wert des Server-Variablen

Eigenschaft

  • TotalBytes - Gibt die Gesamtzahl der Bytes zurück, die im Request-Body vom Client gesendet wurden

Methode

  • BinaryRead - Liefert die Daten zurück, die als Teil der POST-Anfrage vom Client an den Server gesendet wurden

Server-Objekt

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

Eigenschaft

ScriptTimeout - Setzt oder gibt die Zeit zurück, die ein Skript vor dem Abbruch ausführen kann.

Methode

  • CreateObject(type_of_object) - Eine Instanz des Objekts erstellt
  • Execute(Pfad) - Eine andere ASP-Datei aus einer ASP-Datei intern ausführt. Nach dem Abschluss der Ausführung der aufgerufenen ASP-Datei wird die Kontrolle an die ursprüngliche ASP-Datei zurückgegeben
  • ) - Gibt den ASPError-Objekt zurück, der die beschriebene Fehler
  • HTMLEncode(string) - HTML-Kodierung auf eine Zeichenkette angewendet
  • MapPath(Pfad) - Die relative oder virtuelle Pfad wird in einen physikalischen Pfad gemappt
  • Transfer(Pfad) - Senden Sie alle Statusinformationen an eine andere Datei, um sie zu verarbeiten. Nach der Übertragung kehrt die Kontrolle des Programms nicht zum ursprünglichen ASP-Datei zurück
  • URLEncode(string) - Wenden Sie die URL-Encodierung auf den String an

Quelle: http://www.codew3c.com/asp/asp_quickref.asp