ASP hurtig reference

ASP hurtig reference fra CodeW3C.com. Print det ud og gem det i lommen, klar til brug når som helst.

Grundlæggende syntaks

ASP-script er omgivet af <% og %> .Sådan sendes indhold til browseren:

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

ASP's standardprog language er VBScript. Hvis du vil bruge et andet skriptsprog, skal du indsætte en sprogdeklaration i toppen af ASP-siden:

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

Formularer og brugerinput

Request.QueryString bruges til at indsamle værdier fra en formular med method="get". Information, der sendes gennem GET fra en formular, er synlig for alle (vises i browserens adressefelt) og har en begrænsning på mængden af data, der kan sendes.

Request.Form bruges til at indsamle værdier fra en formular med method="post". Information, der sendes gennem POST fra en formular, er ikke synlig for andre og har ingen begrænsning på mængden af data, der kan sendes.

ASP Cookies

Cookies bruges til at genkende brugere. En cookie er en lille fil, som serveren indsætter på brugerens computer. Hver gang den samme computer gennem en browser anmoder om en side, sendes også cookie'en.

Response.Cookies-kommandoen bruges til at oprette cookies:

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

Bemærk: Response.Cookies-kommandoen skal være placeret før <html>-tagget!

"Request.Cookies"-kommandoen bruges til at hente cookie-værdier:

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

Hentet fil

Med #include-instruktionen kan du indarbejde indholdet af en ASP-fil i en anden ASP-fil, før serveren udfører den. #include-instruktionen bruges til at oprette funktioner, sidehoveder, sidesøer eller elementer, der bruges gentagne gange på flere sider.

Syntaks:

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

eller

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

Brug nøglen virtual for at indikere stier, der starter med en virtuel mappe. Hvis filen med navnet "header.inc" befinder sig i den virtuelle mappe /html, vil følgende kode indsætte indholdet af "header.inc":

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

Brug nøgleordet file til at indikere relativ sti. Relativ sti begynder med mappen, der indeholder den refererede fil. Hvis din fil er placeret i html-mappen, og filen "header.inc" er placeret i html\headers, vil nedenstående kode indsætte indholdet af "header.inc":

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

Brug nøgleordet file med syntaks (..\) til at referere til filer i højere niveau mapper.

Global.asa

Global.asa-filen er en valgfri fil, der kan indeholde objektdeklarationer, variabler og metoder, der kan tilgås af hver side i ASP-applikationen.

Kommentar: Global.asa-filen skal gemmes i ASP-applikationens rodmappe, og hver applikation kan kun have én Global.asa-fil.

Global.asa-filen kan kun indeholde følgende indhold:

  • Application begivenheder
  • Session begivenheder
  • <object> erklæring
  • TypeLibrary-deklaration
  • #include instruktion

Application og Session begivenheder

I Global.asa kan du fortælle application og session objekter, hvad der skal ske, når application/session starter og slutter. Koden til denne opgave findes i hændelseshåndteringsprogrammerne.

Kommentar: Når vi indsætter kode i Global.asa-filen, bruger vi ikke <% og %>, vi skal placere subprogrammer inden for HTML <script>-tagget:

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

<object> erklæring

Ved hjælp af <object>-tagget kan du også oprette objekter med session eller application område i Global.asa.

Kommentar: <object>-tagget skal placeres uden for <script>-tagget!

Syntaks:

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

TypeLibrary-deklaration

TypeLibrary er en beholder for indholdet af DLL-filer, der svarer til COM-objekter. Ved at inkludere kald til TypeLibrary i Global.asa-filen kan du få adgang til konstanter i COM-objekterne, og ASP-koden kan rapportere fejl bedre. Hvis din web-applikation afhænger af COM-objekter, der har deklarerede datatyper i typebiblioteket, kan du deklarere dette typebibliotek i Global.asa.

Syntaks:

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

Session-objekt

Session-objektet bruges til at gemme information om brugerens session eller ændre dens indstillinger. Variabler, der gemmes i Session-objektet, indeholder information om en enkelt bruger og kan tilgås af alle sider i en applikation.

sæt

  • Contents - Indeholder alle elementer, der er tilføjet til session via skriptkommandoer
  • StaticObjects - Indeholder alle objekter, der er tilføjet til session via HTML <object>-tagget
  • Contents.Remove(item/index) - Fjern et element fra Contents-samlingen
  • Contents.RemoveAll() - Fjern alle elementer fra Contents-samlingen

egenskab

  • CodePage - Angiv tegnsætten, der bruges til at vise dynamisk indhold
  • LCID - Indstil regionidentifikatoren, der bruges til at vise dynamisk indhold
  • SessionID - Returner session-id
  • Timeout - Indstil eller returner sessionens timeout-tid

metode

  • Abandon - Annuller alle objekter i session-objektet

Application-objekt

En gruppe ASP-filer, der arbejder sammen for at fuldføre en opgave, kaldes en applikation. Application-objektet i ASP bruges til at binde disse filer sammen. Alle brugere deler en Application-objekt. Application-objektet bør indeholde information, der bruges af mange sider i applikationen (f.eks. databaseforbindelsesinformation).

sæt

  • Indhold - indeholder alle elementer, der er tilføjet til applikationen via skriptkommandoer
  • StaticObjects - Indeholder alle objekter, der er tilføjet til applikationen ved hjælp af HTMLs <object>-tag
  • Contents.Remove - Fjerner et element fra Contents-kollektionen
  • Contents.RemoveAll - Fjerner alle elementer fra Contents-kollektionen

metode

  • Lock - Forhindrer brugeren i at ændre variabler i Application-objektet
  • Unlock - Tillader brugeren at ændre variabler i Application-objektet

Response-objektet

Response-objektet bruges til at sende output fra serveren til brugeren

sæt

Cookies(name) - Sætter værdien af cookie. Hvis den ikke findes, oprettes den og værdien sættes

egenskab

  • Buffer - Angiver om output skal bufferes. Når output er sat til at blive bufferet, blokerer serveren svaret til browseren, indtil alle server-scripts er behandlet, eller indtil scriptet kalder Flush eller End-metoden. Hvis denne egenskab skal sættes, skal den placeres før <html>-tagget i .asp-filen
  • CacheControl - Angiver, om proxy-serveren kan cachere output genereret af ASP. Hvis det sættes til Public, vil proxy-serveren cachere siden
  • Charset(charset_name) - Tilføjer navnet på tegnsættet til content-type-hovedet i Response-objektet
  • ContentType - Sætter HTTP-indholdstypen for Response-objektet. (f.eks. "text/html", "image/gif", "image/jpeg", "text/plain"). Standard er "text/html"
  • Expires - Sætter browserens sidecache-tid før udløb (minutter)
  • ExpiresAbsolute - Sætter datoen og klokkeslættet for, hvornår browserens sidecache udløber
  • IsClientConnected - Angiver om klienten har brudt forbindelsen til serveren
  • Pics(pics_label) - Tilføjer værdier til PICS-flagget i response-hovedet
  • Status - Angiver værdien for statuslinjen, der returneres af serveren

metode

  • AddHeader(name, value) - Tilføjer nye HTTP-hoveder og værdier til HTTP-svaret
  • AppendToLog string - Tilføjer en streng til serverens logindgang (server log entry)
  • BinaryWrite(data_to_write) - Skriver data direkte til output uden nogen tegnkonvertering
  • Clear - Rydder den cachede output. Brug denne metode til at håndtere fejl. Hvis Response.Buffer ikke er sat til true, vil denne metode generere en runtime-fejl
  • End - Stopper behandlingen af skriptet og returnerer det aktuelle resultat
  • Flush - Sender straks den cachede output. Hvis Response.Buffer ikke er sat til true, vil denne metode generere en runtime-fejl
  • Redirect(url) - Redirigerer brugeren til en anden URL
  • Write(data_to_write) - Skriver tekst til brugeren

Request-objektet

Når browseren anmoder om en side fra serveren, kaldes det en request. Request-objektet bruges til at få adgang til information fra brugeren

sæt

  • ClientCertificate - Indeholder værdierne af felter, der er gemt i klientcertifikatet
  • Cookies(name) - Indeholder værdierne af cookier
  • Form(element_name) - Indeholder værdierne af formularen. Denne formular skal bruge POST-metoden
  • QueryString(variable_name) - Indeholder værdierne af variablerne i querystring
  • ServerVariables(server_variable) - Indeholder værdierne af servervariable

egenskab

  • TotalBytes - Returnerer det samlede antal bytes, der er sendt af klienten i anmodnings正文

metode

  • BinaryRead - Henter data, der er sendt fra klienten til serveren som en del af en POST-anmodning

Server-objektet

Server-objektet bruges til at få adgang til egenskaber og metoder på serveren

egenskab

ScriptTimeout - Sætter eller returnerer, hvor lang tid et script kan køre, før det afbrydes

metode

  • CreateObject(type_of_object) - Opretter en instans af et objekt
  • Execute(sti) - Udfører en anden ASP-fil fra ASP-filen. Efter at den kaldede ASP-fil er blevet udført, returneres kontrolretur til den oprindelige ASP-fil
  • ) - Returnerer en ASPError-objekt, der beskriver den fejl, der er opstået
  • HTMLEncode(string) - Anvender HTML-kodning på en streng
  • MapPath(sti) - Konverterer relativ eller virtuel sti til fysisk sti
  • Transfer(sti) - Send alle statusinformationer til en anden fil til behandling. Efter overførslen vil kontrol over programmet ikke returnere til den oprindelige ASP-fil
  • URLEncode(string) - Anvend URL-kodningsregler på streng

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