Riferimento rapido ASP
Riferimento rapido ASP da W3Schools. Stampalo e piegalo in tasca.
Sintassi di base
Gli script ASP sono racchiusi tra <% e %>. Per scrivere un output su un browser:
<html>
<body>
<% response.write("Hello World!") %>
</body>
</html>
La lingua predefinita in ASP è VBScript. Per utilizzare un altro linguaggio di scripting, inserisci una specifica del linguaggio nella parte superiore della pagina ASP:
<%@ language="javascript" %>
<html>
<body>
<%
....
%>
Moduli e input dell'utente
Request.QueryString viene utilizzato per raccogliere valori in un modulo con method="get". Le informazioni inviate da un form con il metodo GET sono visibili a tutti (verranno visualizzate nella barra degli indirizzi del browser) e hanno dei limiti sulla quantità di informazioni da inviare.
Request.Form viene utilizzato per raccogliere valori in un modulo con method="post". Le informazioni inviate da un form con il metodo POST sono invisibili agli altri e non hanno limiti alla quantità di informazioni da inviare.
Biscotti ASP
Un cookie viene spesso utilizzato per identificare un utente. Un cookie è un piccolo file che il server incorpora nel computer dell'utente. Ogni volta che lo stesso computer richiede una pagina con un browser, invierà anche il cookie.
Il comando Response.Cookies viene utilizzato per creare i cookie:
<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="10 maggio 2002"
%>
Nota: il comando Response.Cookies deve apparire PRIMA del tag <html>!
Il comando "Request.Cookies" viene utilizzato per recuperare un valore di cookie:
<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>
Compresi i file
È possibile inserire il contenuto di un file ASP in un altro file ASP prima che il server lo esegua, con la direttiva #include. La direttiva #include viene utilizzata per creare funzioni, intestazioni, piè di pagina o elementi che verranno riutilizzati su più pagine
Sintassi:
<!--#include virtual="somefile.inc"-->
o
<!--#include file ="somefile.inc"-->
Utilizzare la parola chiave virtual per indicare un percorso che inizia con una directory virtuale. Se un file denominato "header.inc" risiede in una directory virtuale denominata /html, la riga seguente inserirà il contenuto di "header.inc":
<!-- #include virtual ="/html/header.inc" -->
Utilizzare la parola chiave file per indicare un percorso relativo. Un percorso relativo inizia con la directory che contiene il file incluso. Se hai un file nella directory html e il file "header.inc" risiede in html\headers, la seguente riga inserirà "header.inc" nel tuo file:
<!-- #include file ="headers\header.inc" -->
Utilizzare la parola chiave file con la sintassi (..\) per includere un file da una directory di livello superiore.
Global.asa
Il file Global.asa è un file facoltativo che può contenere dichiarazioni di oggetti, variabili e metodi a cui è possibile accedere da ogni pagina in un'applicazione ASP.
Nota: il file Global.asa deve essere archiviato nella directory principale dell'applicazione ASP e ogni applicazione può avere un solo file Global.asa.
Il file Global.asa può contenere solo quanto segue:
- Eventi applicativi
- Eventi di sessione
- Dichiarazioni <oggetto>
- TipoDichiarazioni di libreria
- la direttiva #include
Applicazione ed eventi di sessione
In Global.asa puoi dire all'applicazione e agli oggetti sessione cosa fare all'avvio dell'applicazione/sessione e cosa fare al termine dell'applicazione/sessione. Il codice per questo viene inserito nei gestori di eventi. Nota: Non utilizziamo <% e %>, per inserire script nel file Global.asa, dobbiamo inserire le subroutine all'interno del tag HTML <script>:
<script language="vbscript" runat="server">
sub Application_OnStart
' del codice
end sub
sub Application_OnEnd
' del codice
end sub
sub Session_OnStart
' del codice
end sub
sub Session_OnEnd
' del codice
end sub
</script>
<oggetto> Dichiarazioni
È anche possibile creare oggetti con ambito di sessione o applicazione in Global.asa utilizzando il tag <object>. Nota: il tag <object> dovrebbe essere esterno al tag <script>!
Sintassi:
<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>
TipoDichiarazioni di libreria
Una TypeLibrary è un contenitore per il contenuto di un file DLL corrispondente a un oggetto COM. Includendo una chiamata a TypeLibrary nel file Global.asa, è possibile accedere alle costanti dell'oggetto COM e gli errori possono essere segnalati meglio dal codice ASP. Se l'applicazione Web si basa su oggetti COM che hanno dichiarato tipi di dati nelle librerie dei tipi, è possibile dichiarare le librerie dei tipi in Global.asa.
Sintassi:
<!--METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->
L'oggetto della sessione
L'oggetto Session viene utilizzato per memorizzare informazioni o modificare le impostazioni per una sessione utente. Le variabili memorizzate nell'oggetto Session contengono informazioni su un singolo utente e sono disponibili per tutte le pagine di un'applicazione.
Collezioni
- Contenuti: contiene tutti gli elementi aggiunti alla sessione con i comandi di script
- StaticObjects: contiene tutti gli oggetti aggiunti alla sessione con il tag <object> e una determinata sessione
- Contents.Remove( item/index ) - Elimina un elemento dalla raccolta Contents
- Contents.RemoveAll() - Elimina ogni elemento dalla raccolta Contents
Proprietà
- CodePage - Imposta la codepage che verrà utilizzata per visualizzare il contenuto dinamico
- LCID - Imposta l'identificatore locale che verrà utilizzato per visualizzare il contenuto dinamico
- SessionID - Restituisce l'ID della sessione
- Timeout - Imposta il timeout per la sessione
Metodo
- Abandon: elimina tutti gli oggetti in un oggetto di sessione
Oggetto dell'applicazione
Un gruppo di file ASP che lavorano insieme per svolgere uno scopo è chiamato applicazione. L'oggetto Application in ASP viene utilizzato per collegare insieme questi file. Tutti gli utenti condividono un oggetto Applicazione. L'oggetto Application dovrebbe contenere informazioni che verranno utilizzate da molte pagine dell'applicazione (come le informazioni sulla connessione al database).
Collezioni
- Contenuto: contiene tutti gli elementi aggiunti all'applicazione con i comandi di script
- StaticObjects: contiene tutti gli oggetti aggiunti all'applicazione con il tag <object>
- Contents.Remove - Elimina un elemento da una raccolta
- Contents.RemoveAll - Elimina ogni elemento da una raccolta
Metodi
- Blocco: impedisce a un utente di modificare le proprietà dell'oggetto dell'applicazione
- Sblocca: consente a un utente di modificare le proprietà dell'oggetto applicazione
L'oggetto di risposta
L'oggetto Response viene utilizzato per inviare l'output all'utente dal server.
Collezione
- Cookies(name) - Imposta un valore per il cookie. Se il cookie non esiste, verrà creato e assumerà il valore specificato
Proprietà
- Buffer - Se bufferizzare o meno l'output. Quando l'output è memorizzato nel buffer, il server tratterrà la risposta fino a quando tutti gli script del server non sono stati elaborati o finché lo script non chiama il metodo Flush o End. Se questa proprietà è impostata, dovrebbe trovarsi prima del tag <html> nel file ASP
- CacheControl - Imposta se i server proxy possono memorizzare nella cache l'output o meno. Quando è impostato su Pubblico, l'output può essere memorizzato nella cache da un server proxy
- Charset( charset_name) - Imposta il nome del set di caratteri (come "ISO8859-1") sull'intestazione del tipo di contenuto
- ContentType - Imposta il tipo di contenuto HTTP (come "text/html", "image/gif", "image/jpeg", "text/plain"). L'impostazione predefinita è "testo/html"
- Scade - Imposta per quanto tempo una pagina verrà memorizzata nella cache su un browser prima che scada
- ExpiresAbsolute - Imposta una data e un'ora in cui una pagina memorizzata nella cache di un browser scadrà
- IsClientConnected: verifica se il client è ancora connesso al server
- Pics( pics_label ) - Aggiunge un valore all'intestazione della risposta dell'etichetta pics
- Stato: specifica il valore della riga di stato
Metodi
- AddHeader( name, value ) - Aggiunge un'intestazione HTML con un valore specificato
- AppendToLog string: aggiunge una stringa alla fine della voce di registro del server
- BinaryWrite( data_to_write ) - Scrive le informazioni fornite senza alcuna conversione del set di caratteri
- Cancella: cancella l'output memorizzato nel buffer. Utilizzare questo metodo per gestire gli errori. Se Response.Buffer non è impostato su true, questo metodo causerà un errore di runtime
- Fine: interrompe l'elaborazione dello script e restituisce il risultato corrente
- Flush: invia immediatamente l'output nel buffer. Se Response.Buffer non è impostato su true, questo metodo causerà un errore di runtime
- Redirect( url ) - Reindirizza l'utente a un altro URL
- Write( data_to_write ) - Scrive un testo all'utente
Richiedi oggetto
Quando un browser richiede una pagina da un server, viene chiamata richiesta. L'oggetto Request viene utilizzato per ottenere informazioni dall'utente.
Collezione
- ClientCertificate: contiene i valori dei campi archiviati nel certificato client
- Cookie( nome ) - Contiene i valori dei cookie
- Form( element_name ) - Contiene i valori del modulo (input). Il modulo deve utilizzare il metodo postale
- QueryString( nome_variabile ) - Contiene i valori delle variabili nella stringa di query
- ServerVariables( server_variable ) - Contiene i valori delle variabili del server
Proprietà
- TotalBytes - Contiene il numero totale di byte che il client sta inviando nel corpo della richiesta
Metodo
- BinaryRead - Recupera i dati inviati al server dal client come parte di una richiesta di post
Oggetto Server
L'oggetto Server viene utilizzato per accedere a proprietà e metodi sul server.
Proprietà
- ScriptTimeout - Imposta per quanto tempo uno script può essere eseguito prima che venga terminato
Metodo
- CreateObject( type_of_object ) - Crea un'istanza di un oggetto
- Execute( path ) - Esegue un file ASP dall'interno di un altro file ASP. Dopo aver eseguito il file ASP chiamato, il controllo viene restituito al file ASP originale
- GetLastError() - Restituisce un oggetto ASPError che descriverà l'errore che si è verificato
- HTMLEncode( string ) - Applica la codifica HTML a una stringa
- MapPath( path ) - Mappa un percorso relativo o virtuale su un percorso fisico
- Trasferimento( percorso ) - Invia tutte le informazioni sullo stato a un altro file ASP per l'elaborazione. Dopo il trasferimento, il controllo procedurale non viene restituito al file ASP originale
- URLEncode( string ): applica le regole di codifica URL a una stringa
Fonte: https://www.w3schools.com/asp/asp_quickref.asp