ASP Snelle Referentie

Rapide referentie voor ASP van CodeW3C.com. Print dit uit, stop het in je broekzak, en gebruik het altijd bij de hand.

Basiskundige grammatica

ASP scripts zijn omgeven door <% en %>. Op deze manier wordt content naar de browser geschreven:

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

De standaard taal in ASP is VBScript. Als u een andere scripttaal wilt gebruiken, voeg dan een taalverklaring toe aan het begin van de ASP-pagina:

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

Formulieren en gebruikersinput

Request.QueryString wordt gebruikt om de waarden van een formulier met method="get" te verzamelen. Informatie die via GET van het formulier wordt verzonden, is zichtbaar voor iedereen (wordt weergegeven in de adresbalk van de browser) en is beperkt in de hoeveelheid gegevens.

Request.Form wordt gebruikt om de waarden van een formulier met method="post" te verzamelen. Informatie die via POST van het formulier wordt verzonden, is niet zichtbaar voor anderen en is niet beperkt in de hoeveelheid gegevens.

ASP Cookies

Cookies worden vaak gebruikt om gebruikers te identificeren. Een cookie is een klein bestand dat de server op de computer van de gebruiker opslaat. Elke keer dat dezelfde computer een pagina opvraagt via de browser, wordt ook de cookie verzonden.

Het commando Response.Cookies wordt gebruikt om cookies te maken:

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

Opmerking: Het commando Response.Cookies moet zich bevinden vóór de <html>-tag!

"Request.Cookies" commando wordt gebruikt om cookie-waarden op te halen:

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

Bestandsverwijzing

Met de #include-instructie kunt u de inhoud van een ASP-bestand in een ander ASP-bestand invoegen voordat het op de server wordt uitgevoerd. De #include-instructie wordt gebruikt om functies, hoofdingen, voetteksten of elementen te maken die op meerdere pagina's worden gebruikt.

Syntaxis:

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

of

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

Gebruik het keyword virtual om het pad dat begint met een virtuele map aan te geven. Als de bestand genaamd "header.inc" zich bevindt in de virtuele map /html, zal het volgende code fragment de inhoud van "header.inc" invoegen:

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

Gebruik de keyword 'file' om een relatieve pad aan te geven. Een relatief pad begint met de map die de verwijzende bestand bevat. Als je bestand zich in de html-map bevindt, en het bestand 'header.inc' zich in html\headers bevindt, zal de onderstaande code de inhoud van 'header.inc' in je bestand invoegen:

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

Gebruik de keyword 'file' en de syntaxis (..\) om bestanden in hogere mappen te verwijzen.

Global.asa

Het Global.asa-bestand is een optioneel bestand en kan objectverklaringen, variabelen en methoden bevatten die door elke pagina van de ASP-applicatie kunnen worden geraadpleegd.

Opmerking: Het Global.asa-bestand moet zich bevinden in de rootdirectory van de ASP-applicatie en elke applicatie kan maar één Global.asa-bestand hebben.

Het Global.asa-bestand mag alleen de volgende inhoud bevatten:

  • Application evenementen
  • Session evenementen
  • <object> declaratie
  • TypeLibrary-declaratie
  • #include instructie

Application en Session evenementen

In Global.asa kun je aangeven wat de application en session-objecten moeten doen wanneer de application/session begint en wanneer deze eindigt. De code voor deze taak bevindt zich in de event handlers.

Opmerking: Bij het invoegen van code in het Global.asa-bestand gebruiken we niet <% en %>, we moeten procedures plaatsen binnen de HTML <script>-tag:

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

<object> declaratie

Met behulp van de <object>-tag kan je ook objecten met session of application-reikwijdte in Global.asa aanmaken.

Opmerking: De <object>-tag moet zich buiten de <script>-tag bevinden!

Syntaxis:

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

TypeLibrary-declaratie

TypeLibrary is een container voor de inhoud van de DLL-bestanden die correleren met COM-objecten. Door een aanroep van de TypeLibrary in het Global.asa-bestand op te nemen, kan toegang worden verkregen tot de constanten van de COM-objecten, en kan ASP-code ook beter fouten rapporteren. Als uw webapplicatie afhankelijk is van COM-objecten die al in de typelibrary zijn gedeclareerd, kunt u deze typelibrary declareren in het Global.asa-bestand.

Syntaxis:

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

Session-object

De Session-object worden gebruikt om informatie over de gebruikerssession op te slaan of de instellingen ervan te wijzigen. De variabelen in de Session-object bevatten informatie over een enkele gebruiker en kunnen door alle pagina's in een applicatie worden benaderd.

collectie

  • Contents - Bevat alle items die met scriptcommando's aan de session zijn toegevoegd
  • StaticObjects - Bevat alle objecten die met de HTML <object>-tag aan de session zijn toegevoegd
  • Contents.Remove(item/index) - Verwijder een item uit de Contents-collectie
  • Contents.RemoveAll() - Verwijder alle items uit de Contents-collectie

eigenschap

  • CodePage - Bepaal de tekenset die wordt gebruikt om dynamische inhoud weer te geven
  • LCID - Stel het regio-identificatie voor gebruik bij het weergeven van dynamische inhoud in
  • SessionID - Retourneer de session id
  • Timeout - Stel in of retourneer de timeout-tijd van de session

methode

  • Abandon - Annuleer alle objecten in de session-object.

Application-object

Een groep ASP-bestanden die samenwerken om een taak te voltooien, wordt een applicatie genoemd. De Application-object in ASP wordt gebruikt om deze bestanden samen te bundelen. Alle gebruikers bundelen een Application-object. Het Application-object moet informatie bevatten die door veel pagina's in de applicatie wordt gebruikt (bijvoorbeeld databaseverbindinginformatie).

collectie

  • Inhoud - Bevat alle items die met scriptcommando's aan de applicatie zijn toegevoegd
  • StaticObjects - Bevat alle objecten die met behulp van de HTML <object>-tag aan het programma zijn toegevoegd
  • Contents.Remove - Verwijder een item uit de Contents-collectie
  • Contents.RemoveAll - Verwijder alle items uit de Contents-collectie

methode

  • Lock - Voorkom dat gebruikers variabelen in het Application-object wijzigen
  • Unlock - Sta gebruikers toe om variabelen in het Application-object te wijzigen

Response-object

Response-object wordt gebruikt om output van de server naar de gebruiker te sturen.

collectie

Cookies(name) - Stel de waarde van de cookie in. Als deze niet bestaat, wordt een cookie aangemaakt en de opgegeven waarde ingesteld.

eigenschap

  • Buffer - Bepaal of de output gebufferd moet worden. Als de output wordt opgeslagen, zal de server de reactie aan de browser verhinderen totdat alle serverscripts zijn verwerkt, of totdat de script de Flush- of End-methode heeft aangeroepen. Als je deze eigenschap wilt instellen, moet deze zich bevinden vóór de <html>-tag in het .asp-bestand.
  • CacheControl - Stel in of de proxyserver de output die door ASP wordt gegenereerd, mag cachen. Als dit op Public is ingesteld, zal de proxyserver de pagina cachen.
  • Charset(charset_name) - Voeg de naam van het karakterset toe aan de content-type-header van het Response-object.
  • ContentType - Stel het HTTP-inhoudstype van het Response-object in. Bijvoorbeeld "text/html", "image/gif", "image/jpeg", "text/plain". Standaard is dit "text/html"
  • Expires - Stel de tijd in (minuten) waarin de pagina in de browsercache wordt opgeslagen voordat deze verloopt
  • ExpiresAbsolute - Stel de datum en tijd in waarop de cache van de browser op de pagina verloopt
  • IsClientConnected - Geef aan of de client al is afgesloten van de server
  • Pics(pics_label) - Voeg waarden toe aan het PICS-teken van de response-header
  • Status - Bepaal de waarde van de statusregel die door de server wordt geretourneerd

methode

  • AddHeader(name, waarde) - Voeg nieuwe HTTP headers en waarden toe aan de HTTP-reactie
  • AppendToLog string - Voeg een string toe aan het einde van het serverlogboek (server log entry)
  • BinaryWrite(data_to_write) - Schrijf gegevens naar de uitvoer zonder enige tekenconversie
  • Clear - Wis de gecachte uitvoer. Gebruik deze methode om fouten te verwerken. Als Response.Buffer niet op true is ingesteld, veroorzaakt deze methode een run-time fout
  • End - Stop het verwerken van het script en geef het huidige resultaat terug
  • Flush - Verzend onmiddellijk de gecachte uitvoer. Als Response.Buffer niet op true is ingesteld, veroorzaakt deze methode een run-time fout
  • Redirect(url) - Redirigeer de gebruiker naar een andere URL
  • Write(data_to_write) - Schrijf tekst naar de gebruiker

Request-object

Wanneer de browser een pagina van de server aanvraagt, wordt dit request genoemd. Het request-object wordt gebruikt om informatie van de gebruiker te verkrijgen.

collectie

  • ClientCertificate - Bevat de waarden die worden opgeslagen in het klantcertificaat
  • Cookies(name) - Bevat de waarde van de cookie
  • Form(element_name) - Bevat de waarde van het formulier. Dit formulier moet worden verstuurd met de POST-methode
  • QueryString(variable_name) - Bevat de waarde van de variabelen in de querystring
  • ServerVariables(server_variable) - Bevat de waarde van de servervariable

eigenschap

  • TotalBytes - Geef het totale aantal bytes terug die door de client in het request-body zijn verzonden

methode

  • BinaryRead - Haal de gegevens op die als onderdeel van een POST-verzoek van de client naar de server zijn gestuurd

Server-object

De Server-object wordt gebruikt om eigenschappen en methoden op de server te bereiken.

eigenschap

ScriptTimeout - Stel in of geef de tijd op die een script mag draaien voordat het wordt afgebroken.

methode

  • CreateObject(type_of_object) - Maak een instantie van een object aan
  • Execute(pad) - Voer een ander ASP-bestand uit van binnen een ASP-bestand. Na het uitvoeren van het aangeroepen ASP-bestand keert de controle terug naar het oorspronkelijke ASP-bestand
  • ) - Geef de ASPError-object die de fout beschrijft terug
  • HTMLEncode(string) - Pas HTML-codering toe op een string
  • MapPath(pad) - Map een relatieve of virtuele pad naar een fysiek pad
  • Transfer(pad) - Stuur alle statusinformatie naar een ander bestand om te verwerken. Na het verzenden van de overdracht keert de controle van het programma niet terug naar het oorspronkelijke ASP-bestand
  • URLEncode(string) - Toepassen van URL-encoding regels op strings

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