Riferimento rapido ASP

Riferimento rapido ASP di CodeW3C.com. Stampalo, mettilo in tasca, per usarlo in qualsiasi momento.

Sintassi di base

Lo script ASP è circondato da <% e %>. In questo modo si invia contenuto al browser:

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

Il linguaggio predefinito di ASP è VBScript. Se si desidera utilizzare un altro linguaggio di scripting, inserire una dichiarazione di linguaggio all'inizio della pagina ASP:

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

Moduli e input utente

Request.QueryString viene utilizzato per raccogliere i valori dei campi di un modulo con method="get". Le informazioni inviate tramite GET sono visibili a tutti ( verranno visualizzate nella barra degli indirizzi del browser) e ci sono limiti sulla quantità di dati inviati.

Request.Form viene utilizzato per raccogliere i valori dei campi di un modulo con method="post". Le informazioni inviate tramite POST dal modulo sono invisibili agli altri e non ci sono limiti sulla quantità di dati inviati.

Cookies ASP

I cookie sono utilizzati per riconoscere gli utenti. I cookie sono piccoli file che il server inserisce nel computer dell'utente. Ogni volta che lo stesso computer richiede una pagina web tramite il browser, vengono anche inviati i cookie.

Il comando Response.Cookies viene utilizzato per creare cookie:

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

Nota: Il comando Response.Cookies deve essere collocato prima del tag <html>!

Il comando "Request.Cookies" viene utilizzato per recuperare i valori dei cookie:

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

Citazione di file

Grazie all'istruzione #include, è possibile inserire il contenuto di un file ASP in un altro ASP prima dell'esecuzione sul server. L'istruzione #include viene utilizzata per creare funzioni, intestazioni di pagina, piè di pagina o elementi ripetuti su più pagine.

Sintassi:

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

oppure

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

Utilizzare la parola chiave virtual per indicare il percorso che inizia da un percorso virtuale. Se il file denominato "header.inc" si trova nel percorso virtuale denominato /html, il seguente codice inserirà il contenuto di "header.inc":

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

请使用关键词 file 来指示相对路径。相对路径以包含该引用文件的目录开头。如果您的文件位于 html 目录中，而文件 "header.inc" 位于 html\headers 中，下面的代码将在您的文件中插入 "header.inc" 的内容：

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

请使用关键词 file 与语法 (..\) 来引用更高层级目录中的文件。

Global.asa

Global.asa 文件是可选文件，可包含能够由 ASP 应用程序中的每个页面访问的对象声明、变量以及方法。

注释：Global.asa 文件必须存放在 ASP 应用程序的根目录中，而且每个应用程序只能有一个 Global.asa 文件。

Global.asa 文件只能包含以下内容：

  • Application 事件
  • Session 事件
  • <object> 声明
  • Dichiarazione TypeLibrary
  • #include 指令

Application 和 Session 事件

在 Global.asa 中，您可以告诉 application 和 session 对象当 application/session 开始时做什么，当 application/session 结束时做什么。完成该任务的代码位于事件处理程序中。

注释：在 Global.asa 文件中插入代码时，我们并不使用 <% 和 %>，我们需要在 HTML <script> 标签内部放置子程序：

<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> 声明

通过使用 <object> 标签，也可以在 Global.asa 中创建带有 session 或 application 作用域的对象。

注释：<object> 标签应该位于 <script> 标签之外！

Sintassi:

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

Dichiarazione TypeLibrary

La TypeLibrary è un contenitore dei contenuti del file DLL che corrisponde agli oggetti COM. Tramite l'inclusione di chiamate alla TypeLibrary nel file Global.asa, è possibile accedere ai costanti degli oggetti COM e migliorare la segnalazione degli errori dal codice ASP. Se il tuo applicazione web dipende da oggetti COM con tipi di dati dichiarati nella libreria di tipi, puoi dichiarare la libreria di tipi nel file Global.asa.

Sintassi:

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

Oggetto Sessione

L'oggetto Sessione viene utilizzato per memorizzare informazioni riguardanti la sessione dell'utente o per modificare le sue impostazioni. Le variabili memorizzate nell'oggetto Sessione contengono informazioni riguardanti un singolo utente e possono essere accedute da tutte le pagine dell'applicazione.

Set

  • Contents - Contiene tutti gli elementi aggiunti alla sessione tramite comandi di script
  • StaticObjects - Contiene tutti gli oggetti aggiunti alla sessione utilizzando il tag <object> di HTML
  • Contents.Remove(item/index) - Rimuove un elemento dalla raccolta Contents
  • Contents.RemoveAll() - Rimuove tutti gli elementi dalla raccolta Contents

Proprietà

  • CodePage - Specifica il set di caratteri utilizzato per visualizzare contenuti dinamici
  • LCID - Imposta l'identificatore di regione utilizzato per visualizzare contenuti dinamici
  • SessionID - Restituisce l'id della sessione
  • Timeout - Imposta o restituisce il tempo di scadenza della sessione

Metodo

  • Abbandona - Revoca tutti gli oggetti presenti nell'oggetto sessione.

Oggetto Application

Un insieme di file ASP che lavorano insieme per completare un compito viene chiamato applicazione. L'oggetto Application in ASP viene utilizzato per incorniciare questi file. Tutti gli utenti condividono un oggetto Application. L'oggetto Application dovrebbe contenere informazioni utilizzate da molte pagine dell'applicazione (ad esempio, informazioni di connessione al database).

Set

  • Contenuti - Contengono tutti i progetti aggiunti all'applicazione tramite comandi di script.
  • StaticObjects - Contiene tutti gli oggetti aggiunti all'applicazione utilizzando il tag <object> HTML
  • Contents.Remove - Rimuove un elemento dalla collezione Contents
  • Contents.RemoveAll - Rimuove tutti gli elementi dalla collezione Contents

Metodo

  • Lock - Impedisce agli utenti di modificare le variabili dell'oggetto Application
  • Unlock - Permette agli utenti di modificare le variabili dell'oggetto Application

Oggetto Response

L'oggetto Response viene utilizzato per inviare l'output dal server all'utente.

Set

Cookies(name) - Imposta il valore del cookie. Se non esiste, crea un cookie e imposta il valore specificato.

Proprietà

  • Buffer - Determina se l'output deve essere bufferizzato. Quando l'output è impostato in cache, il server blocca la risposta al browser fino a che tutti gli script del server sono stati elaborati o fino a che lo script ha chiamato Flush o End. Se si desidera impostare questa proprietà, essa dovrebbe essere posizionata prima del tag <html> nel file .asp.
  • CacheControl - Imposta se il server proxy può cacheare l'output generato da ASP. Se impostato su Public, il server proxy cachea la pagina.
  • Charset(charset_name) - Aggiungi il nome del set di caratteri alla header content-type dell'oggetto Response.
  • ContentType - Imposta il tipo di contenuto HTTP dell'oggetto Response. Ad esempio "text/html", "image/gif", "image/jpeg", "text/plain". Il valore predefinito è "text/html"
  • Expires - Imposta il tempo di cache del browser prima della scadenza della pagina (minuti)
  • ExpiresAbsolute - Imposta la data e l'ora di scadenza della cache della pagina nel browser
  • IsClientConnected - Indica se il client è disconnesso dal server
  • Pics(pics_label) - Aggiungi valori al flag PICS del header response
  • Status - Determina il valore della riga di stato restituita dal server

Metodo

  • AddHeader(name, value) - Aggiungi nuovi header HTTP e valori alla risposta HTTP
  • AppendToLog string - Aggiungi una stringa alla fine del registro del server (server log entry)
  • BinaryWrite(data_to_write) - Scrive direttamente dati all'output senza alcuna conversione di caratteri
  • Clear - Pulisce l'output in cache. Utilizza questo metodo per gestire gli errori. Se Response.Buffer non è impostato su true, questo metodo genererà un errore di runtime
  • End - Ferma il processo dello script e restituisce il risultato corrente
  • Flush - Invia immediatamente l'output in cache. Se Response.Buffer non è impostato su true, questo metodo genererà un errore di runtime
  • Redirect(url) - Redirige l'utente a un altro URL
  • Write(data_to_write) - Scrive testo all'utente

Oggetto Request

Quando il browser richiede una pagina dal server, viene chiamato request. L'oggetto request viene utilizzato per ottenere informazioni dall'utente.

Set

  • ClientCertificate - Contiene i valori dei campi memorizzati nel certificato del client
  • Cookies(name) - Contiene i valori dei cookie
  • Form(element_name) - Contiene i valori dei campi del modulo. Il modulo deve utilizzare il metodo POST
  • QueryString(variable_name) - Contiene i valori delle variabili nella stringa di ricerca
  • ServerVariables(server_variable) - Contiene i valori delle variabili del server

Proprietà

  • TotalBytes - Restituisce il numero totale di byte inviati dal client nel corpo della richiesta

Metodo

  • BinaryRead - Restituisce i dati inviati dal client al server come parte di una richiesta POST

Oggetto Server

L'oggetto Server viene utilizzato per accedere alle proprietà e ai metodi sul server.

Proprietà

ScriptTimeout - Imposta o restituisce quanto tempo può durare un script prima di essere terminato.

Metodo

  • CreateObject(type_of_object) - Crea un'istanza dell'oggetto
  • Execute(path) - Esegue un altro file ASP all'interno del file ASP. Dopo che il file ASP chiamato è stato eseguito, il controllo passa al file ASP originale
  • ) - Restituisce l'oggetto ASPError che descrive l'errore verificato
  • HTMLEncode(string) - Applica l'encoding HTML a una stringa
  • MapPath(path) - Mappa un percorso relativo o virtuale a un percorso fisico
  • Transfer(path) - Invia tutte le informazioni di stato a un altro file per essere elaborate. Dopo la trasmissione, il controllo del programma non tornerà al file ASP originale
  • URLEncode(string) - Applica le regole di codifica URL alla stringa

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