ASP snelle referentie


ASP Quick Reference van W3Schools. Print het uit en vouw het in je zak.


Basissyntaxis

ASP-scripts zijn omgeven door <% en %>. Om wat uitvoer naar een browser te schrijven:

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

De standaardtaal in ASP is VBScript. Om een ​​andere scripttaal te gebruiken, voegt u een taalspecificatie toe bovenaan de ASP-pagina:

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

<%
....
%>


Formulieren en gebruikersinvoer

Request.QueryString wordt gebruikt om waarden te verzamelen in een vorm met method="get". Informatie die wordt verzonden vanaf een formulier met de GET-methode is voor iedereen zichtbaar (deze wordt weergegeven in de adresbalk van de browser) en heeft limieten voor de hoeveelheid informatie die moet worden verzonden.

Request.Form wordt gebruikt om waarden te verzamelen in een formulier met method="post". Informatie die wordt verzonden vanaf een formulier met de POST-methode is onzichtbaar voor anderen en kent geen limiet voor de hoeveelheid informatie die moet worden verzonden.


ASP-cookies

Een cookie wordt vaak gebruikt om een ​​gebruiker te identificeren. Een cookie is een klein bestand dat de server op de computer van de gebruiker insluit. Elke keer dat dezelfde computer om een ​​pagina met een browser vraagt, stuurt deze ook de cookie.

De opdracht Response.Cookies wordt gebruikt om cookies te maken:

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="10 mei 2002"
%>

Opmerking: de opdracht Response.Cookies moet VOOR de tag <html> verschijnen!

De opdracht "Request.Cookies" wordt gebruikt om een ​​cookiewaarde op te halen:

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



Inclusief bestanden

U kunt de inhoud van het ene ASP-bestand in een ander ASP-bestand invoegen voordat de server het uitvoert, met de instructie #include. De instructie #include wordt gebruikt om functies, kopteksten, voetteksten of elementen te maken die op meerdere pagina's opnieuw worden gebruikt

Syntaxis:

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

Gebruik het virtuele trefwoord om een ​​pad aan te geven dat begint met een virtuele map. Als een bestand met de naam "header.inc" zich in een virtuele map met de naam /html bevindt, zou de volgende regel de inhoud van "header.inc" invoegen:

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

Gebruik het trefwoord bestand om een ​​relatief pad aan te geven. Een relatief pad begint met de map die het inclusief bestand bevat. Als je een bestand in de html-directory hebt en het bestand "header.inc" staat in html\headers, dan zou de volgende regel "header.inc" in je bestand invoegen:

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

Gebruik het sleutelwoord file met de syntaxis (..\) om een ​​bestand uit een hogere directory op te nemen.


Global.asa

Het bestand Global.asa is een optioneel bestand dat declaraties van objecten, variabelen en methoden kan bevatten die toegankelijk zijn voor elke pagina in een ASP-toepassing.

Opmerking: het Global.asa-bestand moet worden opgeslagen in de hoofdmap van de ASP-toepassing en elke toepassing kan slechts één Global.asa-bestand hebben.

Het bestand Global.asa kan alleen het volgende bevatten:

  • Toepassingsgebeurtenissen
  • Sessie-evenementen
  • <object> declaraties 
  • TypeBibliotheekaangiften
  • de #include-richtlijn

Applicatie- en sessie-evenementen

In Global.asa kunt u de applicatie- en sessie-objecten vertellen wat ze moeten doen wanneer de applicatie/sessie start en wat ze moeten doen wanneer de applicatie/sessie eindigt. De code hiervoor wordt in event handlers geplaatst. Opmerking: we gebruiken geen <% en %>, om scripts in het Global.asa-bestand in te voegen, moeten we de subroutines in de HTML <script>-tag plaatsen:

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

Het is ook mogelijk om objecten met een sessie- of toepassingsbereik te maken in Global.asa door de tag <object> te gebruiken. Opmerking: de <object>-tag moet buiten de <script>-tag staan!

Syntaxis:

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

Type Bibliotheekverklaringen

Een TypeLibrary is een container voor de inhoud van een DLL-bestand dat overeenkomt met een COM-object. Door een aanroep van de TypeLibrary in het bestand Global.asa op te nemen, zijn de constanten van het COM-object toegankelijk en kunnen fouten beter worden gemeld door de ASP-code. Als uw webtoepassing afhankelijk is van COM-objecten die gegevenstypen hebben gedeclareerd in typebibliotheken, kunt u de typebibliotheken declareren in Global.asa.

Syntaxis:

 <!--METADATA TYPE="TypeLib"
file="bestandsnaam"
uuid="typelibraryuuid"
version="versienummer"
lcid="localeid"
-->


Het sessie-object

Het Session-object wordt gebruikt om informatie over een gebruikerssessie op te slaan of instellingen te wijzigen. Variabelen die zijn opgeslagen in het Session-object bevatten informatie over één enkele gebruiker en zijn beschikbaar voor alle pagina's in één toepassing.

Collecties

  • Inhoud - Bevat elk item dat aan de sessie is toegevoegd met scriptopdrachten
  • StaticObjects - Bevat elk object dat aan de sessie is toegevoegd met de tag <object> en een bepaalde sessie
  • Contents.Remove( item/index ) - Verwijdert een item uit de Contents-collectie
  • Contents.RemoveAll() - Verwijdert elk item uit de Contents-collectie

Eigenschappen

  • CodePage - Stelt de codepagina in die wordt gebruikt om dynamische inhoud weer te geven
  • LCID - Stelt de landinstelling in die wordt gebruikt om dynamische inhoud weer te geven
  • SessionID - Retourneert de sessie-ID
  • Time-out - Stelt de time-out voor de sessie in

Methode

  • Abandon - Doodt elk object in een sessie-object

Toepassingsobject

Een groep ASP-bestanden die samenwerken om een ​​bepaald doel te bereiken, wordt een toepassing genoemd. Het Application-object in ASP wordt gebruikt om deze bestanden aan elkaar te koppelen. Alle gebruikers delen één toepassingsobject. Het toepassingsobject moet informatie bevatten die door veel pagina's in de toepassing zal worden gebruikt (zoals gegevens over de databaseverbinding).

Collecties

  • Inhoud - Bevat elk item dat met scriptopdrachten aan de applicatie is toegevoegd
  • StaticObjects - Bevat elk object dat aan de toepassing is toegevoegd met de tag <object>
  • Contents.Remove - Verwijdert een item uit een verzameling
  • Contents.RemoveAll - Verwijdert elk item uit een verzameling

Methoden:

  • Vergrendelen - Voorkomt dat een gebruiker de eigenschappen van het toepassingsobject wijzigt
  • Ontgrendelen - Hiermee kan een gebruiker de eigenschappen van het toepassingsobject wijzigen

Het antwoordobject

Het Response Object wordt gebruikt om output vanaf de server naar de gebruiker te sturen.

Verzameling

  • Cookies(naam) - Stelt een cookiewaarde in. Als de cookie niet bestaat, wordt deze gemaakt en neemt de waarde aan die is opgegeven

Eigenschappen

  • Buffer - Of de uitvoer moet worden gebufferd of niet. Wanneer de uitvoer wordt gebufferd, zal de server het antwoord tegenhouden totdat alle serverscripts zijn verwerkt, of totdat het script de Flush- of End-methode aanroept. Als deze eigenschap is ingesteld, moet deze vóór de tag <html> in het ASP-bestand staan
  • CacheControl - Stelt in of proxyservers de uitvoer kunnen cachen of niet. Indien ingesteld op Openbaar, kan de uitvoer worden gecached door een proxyserver
  • Charset( charset_name) - Stelt de naam van de tekenset (zoals "ISO8859-1") in op de koptekst van het inhoudstype
  • ContentType - Stelt het HTTP-inhoudstype in (zoals "text/html", "image/gif", "image/jpeg", "text/plain"). Standaard is "tekst/html"
  • Verloopt - Hiermee stelt u in hoe lang een pagina in een browser in de cache wordt bewaard voordat deze verloopt
  • ExpiresAbsolute - Stelt een datum en tijd in waarop een pagina in de cache in een browser verloopt
  • IsClientConnected - Controleert of de client nog steeds is verbonden met de server
  • Pics( pics_label ) - Voegt een waarde toe aan de responsheader van het fotolabel
  • Status - Specificeert de waarde van de statusregel

Methoden:

  • AddHeader( name, value ) - Voegt een HTML-header toe met een gespecificeerde waarde
  • AppendToLog string - Voegt een string toe aan het einde van het serverlogitem
  • BinaryWrite( data_to_write ) - Schrijft de gegeven informatie zonder enige tekensetconversie
  • Wissen - Wist de gebufferde uitvoer. Gebruik deze methode om fouten af ​​te handelen. Als Response.Buffer niet is ingesteld op true, veroorzaakt deze methode een runtime-fout
  • End - Stopt met het verwerken van het script en retourneert het huidige resultaat
  • Flush - Stuurt gebufferde uitvoer onmiddellijk. Als Response.Buffer niet is ingesteld op true, veroorzaakt deze methode een runtime-fout
  • Redirect( url ) - Leidt de gebruiker om naar een andere url
  • Write( data_to_write ) - Schrijft een tekst naar de gebruiker

Verzoek object

Wanneer een browser om een ​​pagina van een server vraagt, wordt dit een verzoek genoemd. Het Request Object wordt gebruikt om informatie van de gebruiker te krijgen.

Verzameling

  • ClientCertificate - Bevat veldwaarden die zijn opgeslagen in het clientcertificaat
  • Cookies ( naam ) - Bevat cookie-waarden
  • Form( element_name ) - Bevat formulier (invoer) waarden. Het formulier moet de post-methode gebruiken
  • QueryString( variable_name ) - Bevat variabele waarden in de query string
  • ServerVariables( server_variable ) - Bevat waarden van servervariabelen

Eigendom

  • TotalBytes - Bevat het totale aantal bytes dat de client verzendt in de hoofdtekst van het verzoek

Methode

  • BinaryRead - Haalt de gegevens op die van de client naar de server worden verzonden als onderdeel van een postverzoek

Serverobject

Het serverobject wordt gebruikt om toegang te krijgen tot eigenschappen en methoden op de server.

Eigendom

  • ScriptTimeout - Stelt in hoe lang een script kan worden uitgevoerd voordat het wordt beëindigd

Methode

  • CreateObject( type_of_object ) - Maakt een instantie van een object
  • Execute( path ) - Voert een ASP-bestand uit vanuit een ander ASP-bestand. Na het uitvoeren van het aangeroepen ASP-bestand, keert de besturing terug naar het oorspronkelijke ASP-bestand
  • GetLastError() - Retourneert een ASPError-object dat de opgetreden fout beschrijft
  • HTMLEncode( string ) - Past HTML-codering toe op een string
  • MapPath( path ) - Wijst een relatief of virtueel pad toe aan een fysiek pad
  • Transfer( path ) - Stuurt alle statusinformatie naar een ander ASP-bestand voor verwerking. Na de overdracht wordt de procedurele controle niet teruggegeven aan het oorspronkelijke ASP-bestand
  • URLEncode( string ) - Past URL-coderingsregels toe op een string

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