ASP- Schnellreferenz


ASP-Schnellreferenz von W3Schools. Drucken Sie es aus und falten Sie es in Ihrer Tasche.


Grundlegende Syntax

ASP-Skripte sind von <% und %> umgeben. So schreiben Sie eine Ausgabe in einen Browser:

<html>
<body>
<% response.write("Hallo Welt!") %>
</body>
</html>

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

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

<%
....
%>


Formulare und Benutzereingaben

Request.QueryString wird verwendet, um Werte in einem Formular mit method="get" zu sammeln. Informationen, die von einem Formular mit der GET-Methode gesendet werden, sind für jeden sichtbar (sie werden in der Adressleiste des Browsers angezeigt) und haben eine Begrenzung der zu sendenden Informationsmenge.

Request.Form wird verwendet, um Werte in einem Formular mit method="post" zu sammeln. Informationen, die von einem Formular mit der POST-Methode gesendet werden, sind für andere unsichtbar und es gibt keine Beschränkungen hinsichtlich der zu sendenden Informationsmenge.


ASP-Cookies

Ein Cookie wird häufig verwendet, um einen Benutzer zu identifizieren. Ein Cookie ist eine kleine Datei, die der Server auf dem Computer des Benutzers einbettet. Jedes Mal, wenn derselbe Computer eine Seite mit einem Browser anfordert, sendet er auch das Cookie.

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

<%
Response.Cookies("Vorname")="Alex"
Response.Cookies("Vorname").Expires="10. Mai 2002"
%>

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

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

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



Einschließlich Dateien

Mit der Direktive #include können Sie den Inhalt einer ASP-Datei in eine andere ASP-Datei einfügen, bevor der Server sie ausführt. Die Direktive #include wird verwendet, um Funktionen, Kopfzeilen, Fußzeilen oder Elemente zu erstellen, die auf mehreren Seiten wiederverwendet werden

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“ in einem virtuellen Verzeichnis namens /html befindet, würde die folgende Zeile den Inhalt von „header.inc“ einfügen:

<!-- #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 inkludierende Datei enthält. Wenn Sie eine Datei im HTML-Verzeichnis haben und die Datei „header.inc“ sich in html\headers befindet, würde die folgende Zeile „header.inc“ in Ihre Datei einfügen:

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

Verwenden Sie das Schlüsselwort file mit der Syntax (..\), um eine Datei aus einem übergeordneten Verzeichnis einzuschließen.


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 Datei Global.asa haben.

Die Datei Global.asa darf nur Folgendes enthalten:

  • Bewerbungsveranstaltungen
  • Sitzungsereignisse
  • <Objekt>-Deklarationen 
  • TypeLibrary-Deklarationen
  • die #include-Direktive

Bewerbungs- und Sitzungsveranstaltungen

In Global.asa können Sie den Anwendungs- und Sitzungsobjekten mitteilen, was zu tun ist, wenn die Anwendung/Sitzung beginnt, und was zu tun ist, wenn die Anwendung/Sitzung endet. Der Code dafür wird in Event-Handlern platziert. Hinweis: Wir verwenden <% und %> nicht, um Skripte in die Datei Global.asa einzufügen, müssen wir die Unterroutinen in das HTML-Tag <script> einfügen:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' etwas Codeende
sub
sub Application_OnEnd
  ' etwas Codeende
sub
sub Session_OnStart
  ' etwas Codeende
sub
sub Session_OnEnd
  ' etwas Codeende
sub
</script>

<Objekt> Deklarationen

Es ist auch möglich, Objekte mit Sitzungs- oder Anwendungsbereich in Global.asa zu erstellen, indem Sie das <object>-Tag verwenden. Hinweis: Das <object>-Tag sollte außerhalb des <script>-Tags stehen!

Syntax:

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

TypeLibrary-Deklarationen

Eine TypeLibrary ist ein Container für den Inhalt einer DLL-Datei, die einem COM-Objekt entspricht. Durch Einfügen eines Aufrufs der TypeLibrary in die Datei Global.asa kann auf die Konstanten des COM-Objekts zugegriffen werden, und Fehler können vom ASP-Code besser gemeldet werden. Wenn Ihre Webanwendung auf COM-Objekten basiert, die Datentypen in Typbibliotheken deklariert haben, können Sie die Typbibliotheken in Global.asa deklarieren.

Syntax:

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


Das Sitzungsobjekt

Das Session-Objekt wird verwendet, um Informationen über eine Benutzersitzung zu speichern oder Einstellungen für eine Benutzersitzung zu ändern. Im Session-Objekt gespeicherte Variablen enthalten Informationen über einen einzelnen Benutzer und stehen allen Seiten in einer Anwendung zur Verfügung.

Sammlungen

  • Inhalt – Enthält jedes Element, das der Sitzung mit Skriptbefehlen hinzugefügt wurde
  • StaticObjects – Enthält jedes Objekt, das der Sitzung mit dem <object>-Tag hinzugefügt wurde, und eine bestimmte Sitzung
  • Contents.Remove( item/index ) – Löscht ein Element aus der Contents-Auflistung
  • Contents.RemoveAll() – Löscht alle Elemente aus der Contents-Sammlung

Eigenschaften

  • CodePage – Legt die Codepage fest, die zum Anzeigen dynamischer Inhalte verwendet wird
  • LCID – Legt den Gebietsschemabezeichner fest, der zum Anzeigen dynamischer Inhalte verwendet wird
  • Sitzungs-ID – Gibt die Sitzungs-ID zurück
  • Timeout – Legt das Timeout für die Sitzung fest

Methode

  • Abandon – Beendet jedes Objekt in einem Sitzungsobjekt

Anwendungsobjekt

Eine Gruppe von ASP-Dateien, die zusammenarbeiten, um einen bestimmten Zweck zu erfüllen, wird als Anwendung bezeichnet. Das Application-Objekt in ASP wird verwendet, um diese Dateien zusammenzubinden. Alle Benutzer teilen sich ein Anwendungsobjekt. Das Anwendungsobjekt sollte Informationen enthalten, die von vielen Seiten in der Anwendung verwendet werden (z. B. Datenbankverbindungsinformationen).

Sammlungen

  • Inhalt – Enthält jedes Element, das der Anwendung mit Skriptbefehlen hinzugefügt wurde
  • StaticObjects – enthält jedes Objekt, das der Anwendung mit dem <object>-Tag hinzugefügt wurde
  • Contents.Remove – Löscht ein Element aus einer Sammlung
  • Contents.RemoveAll – Löscht alle Elemente aus einer Sammlung

Methoden

  • Sperren – Verhindert, dass ein Benutzer die Anwendungsobjekteigenschaften ändert
  • Entsperren – Ermöglicht einem Benutzer, die Anwendungsobjekteigenschaften zu ändern

Das Response-Objekt

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

Sammlung

  • Cookies(Name) – Legt einen Cookie-Wert fest. Wenn das Cookie nicht vorhanden ist, wird es erstellt und nimmt den angegebenen Wert an

Eigenschaften

  • Puffer – Ob die Ausgabe gepuffert werden soll oder nicht. Wenn die Ausgabe gepuffert wird, hält der Server die Antwort zurück, bis alle Serverskripts verarbeitet wurden oder bis das Skript die Flush- oder End-Methode aufruft. Wenn diese Eigenschaft festgelegt ist, sollte sie vor dem <html>-Tag in der ASP-Datei stehen
  • CacheControl - Legt fest, ob Proxy-Server die Ausgabe zwischenspeichern können oder nicht. Bei Einstellung auf Öffentlich kann die Ausgabe von einem Proxyserver zwischengespeichert werden
  • Charset( charset_name) – Setzt den Namen des Zeichensatzes (wie „ISO8859-1“) auf den Header des Inhaltstyps
  • ContentType – Legt den HTTP-Inhaltstyp fest (wie „text/html“, „image/gif“, „image/jpeg“, „text/plain“). Standard ist "text/html"
  • Läuft ab – Legt fest, wie lange eine Seite in einem Browser zwischengespeichert wird, bevor sie abläuft
  • ExpiresAbsolute – Legt ein Datum und eine Uhrzeit fest, wann eine in einem Browser zwischengespeicherte Seite abläuft
  • IsClientConnected – Überprüft, ob der Client noch mit dem Server verbunden ist
  • Pics( pics_label ) – Fügt einen Wert zum Antwortheader der Bildbezeichnung hinzu
  • Status – Gibt den Wert der Statuszeile an

Methoden

  • AddHeader( name, value ) – Fügt einen HTML-Header mit einem angegebenen Wert hinzu
  • AppendToLog string – Fügt am Ende des Serverprotokolleintrags eine Zeichenfolge hinzu
  • BinaryWrite( data_to_write ) – Schreibt die angegebenen Informationen ohne Zeichensatzkonvertierung
  • Clear – Löscht die gepufferte Ausgabe. Verwenden Sie diese Methode, um Fehler zu behandeln. Wenn Response.Buffer nicht auf true festgelegt ist, verursacht diese Methode einen 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 festgelegt ist, verursacht diese Methode einen Laufzeitfehler
  • Redirect( url ) – Leitet den Benutzer zu einer anderen URL um
  • Write( data_to_write ) - Schreibt einen Text an den Benutzer

Objekt anfordern

Wenn ein Browser eine Seite von einem Server anfordert, wird dies als Anfrage bezeichnet. Das Request-Objekt wird verwendet, um Informationen vom Benutzer zu erhalten.

Sammlung

  • ClientCertificate – Enthält Feldwerte, die im Clientzertifikat gespeichert sind
  • Cookies( name ) - Enthält Cookie-Werte
  • Form( element_name ) – Enthält Formular-(Eingabe-)Werte. Das Formular muss die post-Methode verwenden
  • QueryString( variable_name ) – Enthält Variablenwerte in der Abfragezeichenfolge
  • ServerVariables( server_variable ) – Enthält Servervariablenwerte

Eigentum

  • TotalBytes – Enthält die Gesamtzahl der Bytes, die der Client im Hauptteil der Anfrage sendet

Methode

  • BinaryRead – Ruft die Daten ab, die vom Client als Teil einer Post-Anforderung an den Server gesendet werden

Server-Objekt

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

Eigentum

  • ScriptTimeout – Legt fest, wie lange ein Skript ausgeführt werden kann, bevor es beendet wird

Methode

  • CreateObject( type_of_object ) – Erstellt eine Instanz eines Objekts
  • Execute( path ) - Führt eine ASP-Datei aus einer anderen ASP-Datei heraus aus. Nach dem Ausführen der aufgerufenen ASP-Datei wird die Steuerung an die ursprüngliche ASP-Datei zurückgegeben
  • GetLastError() – Gibt ein ASPError-Objekt zurück, das den aufgetretenen Fehler beschreibt
  • HTMLEncode( string ) – Wendet HTML-Codierung auf eine Zeichenfolge an
  • MapPath( path ) – Ordnet einem physischen Pfad einen relativen oder virtuellen Pfad zu
  • Transfer( path ) - Sendet alle Zustandsinformationen zur Verarbeitung an eine andere ASP-Datei. Nach der Übertragung wird die Verfahrenskontrolle nicht an die ursprüngliche ASP-Datei zurückgegeben
  • URLEncode( string ) – Wendet URL-Codierungsregeln auf eine Zeichenfolge an

Quelle: https://www.w3schools.com/asp/asp_quickref.asp