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