ASP quick reference

Snabbreferens för ASP från CodeW3C.com. Skriv ut, lägg i fickan och använd när som helst.

Grundläggande syntax

ASP-skript är omgiven av <% och %>. På detta sätt skickas innehåll till webbläsaren:

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

Standard språket i ASP är VBScript. Om du vill använda ett annat skriptspråk, lägg till en språkdeklaration i toppen av ASP-sidan:

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

Formulär och användarinput

Request.QueryString används för att samla in värden från en form med method="get". Information som skickas via GET från formuläret är synlig för alla (visas i webbläsarens adressfält) och har begränsningar för mängden data som kan skickas.

Request.Form används för att samla in värden från en formulär med method="post". Information som skickas via POST från formuläret är inte synlig för andra och har inga begränsningar för mängden data som kan skickas.

ASP Cookies

Cookies används för att känna igen användare. En cookie är en liten fil som servern lägger till användarens dator. Varje gång samma dator begär en sida via webbläsaren, skickas också cookie:n.

Kommandot Response.Cookies används för att skapa cookies:

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

Kommentar: Kommandot Response.Cookies måste vara innan <html>-taggen!

"Request.Cookies"-kommandot används för att hämta cookie-värden:

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

Citatfil

Genom att använda #include-instruktionen kan du infoga innehållet från en ASP-fil i en annan ASP-fil innan servern utför den. #include-instruktionen används för att skapa funktioner, sidhuvuden, sidfötter eller element som används på flera sidor.

Syntaks:

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

eller

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

Använd nyckelordet virtual för att indikera en sökväg som börjar med en virtuell katalog. Om filen "header.inc" finns i den virtuella katalogen /html, kommer följande kod att infoga innehållet från "header.inc":

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

Använd nyckelordet file för att indikera relativ sökväg. Relativ sökväg börjar med katalogen som innehåller den refererade filen. Om din fil ligger i html-katalogen och filen "header.inc" ligger i html\headers, kommer följande kod att infoga innehållet i "header.inc":

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

Använd nyckelordet file och syntaxen (..\) för att hänvisa till filer i högre nivådatorer.

Global.asa

Global.asa-filen är en valfri fil som kan innehålla objektsförklaringar, variabler och metoder som kan nås av varje sida i ASP-applikationen.

Kommentar: Global.asa-filen måste lagras i rotdirektivet för ASP-applikationen, och varje applikation kan endast ha en Global.asa-fil.

Global.asa-filen kan endast innehålla följande:

  • Application-händelser
  • Session-händelser
  • <object>-deklaration
  • TypeLibrary-deklaration
  • #include-instruktion

Application och Session-händelser

I Global.asa kan du säga vad som ska hända när application och session startar och slutar. Koden för detta finns i händels hanterare.

Kommentar: När vi lägger till kod i Global.asa-filen använder vi inte <% och %>, vi måste placera subprogrammen inom HTML <script>-taggen:

<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>-deklaration

Genom att använda <object>-taggen kan du också skapa objekt med session eller application-omfattning i Global.asa.

Kommentar: <object>-taggen bör placeras utanför <script>-taggen!

Syntaks:

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

TypeLibrary-deklaration

TypeLibrary är en behållare för innehållet i DLL-filer som motsvarar COM-objekt. Genom att inkludera en anrop till TypeLibrary i Global.asa-filen kan du komma åt konstanterna för COM-objekt och ASP-koden kan också rapportera fel bättre. Om din webbapplikation är beroende av COM-objekt som har deklareras som datatyper i typbiblioteket, kan du deklarera denna typbibliotek i Global.asa.

Syntaks:

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

Session-objekt

Session-objektet används för att lagra information om användar-sessioner eller ändra dess inställningar. Variablerna som lagras i Session-objektet innehåller information om en enskild användare och kan åtkommas av alla sidor i en applikation.

Samling

  • Contents - Innehåller alla poster som läggs till i sessionen med skriptkommandon
  • StaticObjects - Innehåller alla objekt som läggs till i sessionen med HTML <object>-taggen
  • Contents.Remove(item/index) - Ta bort ett objekt från Contents-kollektionen
  • Contents.RemoveAll() - Ta bort alla objekt från Contents-kollektionen

Egenskap

  • CodePage - Bestäm teckenuppsättningen som används för att visa dynamiskt innehåll
  • LCID - Ställ in regionindikatorn som används för att visa dynamiskt innehåll
  • SessionID - Returnera session-id
  • Timeout - Ställ in eller returnera sessionens utgångstid

Metod

  • Abandon - Annullera alla objekt i session-objektet.

Application-objekt

En grupp ASP-filer som samarbetar för att utföra ett specifikt jobb kallas en applikation. Application-objektet i ASP används för att samla ihop dessa filer. Alla användare delar en Application-objekt. Application-objektet bör innehålla information som används av många sidor i applikationen (t.ex. databasanslutningsinformation).

Samling

  • Innehåll - Innehåller alla objekt som läggs till i applikationen med skriptkommandon
  • StaticObjects - Innehåller alla objekt som har lagts till i applikationen med hjälp av HTML <object>-taggar
  • Contents.Remove - Ta bort en post från Contents-kollektionen
  • Contents.RemoveAll - Ta bort alla poster från Contents-kollektionen

Metod

  • Lock - Förhindrar användare att ändra variabler i Application-objektet
  • Unlock - Tillåter användare att ändra variabler i Application-objektet

Response-objekt

Response-objektet används för att skicka utdata från servern till användaren.

Samling

Cookies(name) - Ställ in värdet för cookie. Om den inte finns, skapa cookie och ställ in det angivna värdet.

Egenskap

  • Buffer - Bestämmer om utdata ska buffras. När utdata är inställd till att cacha kommer servern att förhindra att svara till webbläsaren, tills alla serverScripts har hanterats, eller tills skriptet har anropat Flush eller End-metoden. Om du vill ställa in detta attribut bör det vara innan <html>-taggen i .asp-filen.
  • CacheControl - Ställ in om proxyservern kan cacha ASP-genererad utdata. Om den är satt till Public kommer proxyservern att cacha sidan.
  • Charset(charset_name) - Lägg till namnet på teckenuppsättningen till content-type-huvudet i Response-objektet.
  • ContentType - Ställ in HTTP-innehållstyp för Response-objektet. Till exempel "text/html", "image/gif", "image/jpeg", "text/plain". Standard är "text/html"
  • Expires - Ställ in tid för att sidcachning ska upphöra innan sidan blir ogiltig (minuter)
  • ExpiresAbsolute - Ställ in datum och tid för att webbläsarens sidcachning ska upphöra
  • IsClientConnected - Indikerar om klienten har kopplat från servern
  • Pics(pics_label) - Lägg till värden till PICS-tagg i response-huvud
  • Status - Bestämmer värdet för statusraden som servern returnerar

Metod

  • AddHeader(name, value) - Lägg till nya HTTP-huvuden och värden i HTTP-svar
  • AppendToLog string - Lägg till sträng till slutet av serverns logg (server log entry)
  • BinaryWrite(data_to_write) - Skriver data direkt till utmatningen utan någon karaktärsomvandling
  • Clear - Rensar den cachade utmatningen. Använd denna metod för att hantera fel. Om Response.Buffer inte är satt till true, kommer denna metod att generera en runtime-fel
  • End - Stoppar behandlingen av skriptet och returnerar det aktuella resultatet
  • Flush - Skickar omedelbart det cachade utmatningen. Om Response.Buffer inte är satt till true, kommer denna metod att generera en runtime-fel
  • Redirect(url) - Omdirigerar användaren till en annan URL
  • Write(data_to_write) - Skriver text till användaren

Request-objekt

När webbläsaren begär en sida från servern, kallas det request. Request-objektet används för att hämta information från användaren.

Samling

  • ClientCertificate - Innehåller värden som lagras i kundcertifikatet
  • Cookies(name) - Innehåller värden för cookies
  • Form(element_name) - Innehåller värden för formulär. Detta formulär måste använda POST-metoden
  • QueryString(variable_name) - Innehåller värden för variabler i querysträngen
  • ServerVariables(server_variable) - Innehåller värden för servervariabler

Egenskap

  • TotalBytes - Returnerar det totala antalet byte som klienten har skickat i bodyn av förfrågan

Metod

  • BinaryRead - Hämtar data som skickats från klienten till servern som en del av en POST-fostran

Server-objekt

Server-objektet används för att komma åt egenskaper och metoder på servern.

Egenskap

ScriptTimeout - Ställer in eller returnerar hur lång tid ett skript kan köra innan det avbryts.

Metod

  • CreateObject(type_of_object) - Skapar en instans av ett objekt
  • Execute(path) - Kör en annan ASP-fil från inuti en ASP-fil. Efter att den anropade ASP-filen har körts, återvänder kontrollen till den ursprungliga ASP-filen
  • ) - Returnerar ASPError-objektet som beskriver den fel som har inträffat
  • HTMLEncode(string) - Tillämpar HTML-kodning på strängen
  • MapPath(path) - Maperar relativ eller virtuell sökväg till fysisk sökväg
  • Transfer(path) - Send all status information to another file for processing. After transmission, control of the program will not return to the original ASP file
  • URLEncode(string) - Apply URL encoding rules to strings

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