Vademecum delle funzioni
DatabaseDBConnexion(sDBName)La funzione DBConnexion permette di stabilire una connessione ad un database.
La funzione accetta come parametro il nome del database, senza l’estensione e restituisce come risultato l’apertura della connessione.
Utilizzo: per connettersi al database “forum.mdb”, posizionato nella cartella predefinita per i database č sufficiente utilizzare questo codice:
<%
Set oCn = DBConnexion(“forum”)
…
oCn.Close
Set oCn = Nothing
%>
La connessione aperta ha nome “oCn” e necessita della chiusura della connessione.
La funzione č ritrovabile nel file <Root>/includes/database-inc.asp.
DBRecordset (oCn, rSQL)La funzione DBRecordset permette di ricavare un recordset da una query SQL.
La funzione accetta come parametri il nome della connessione e la stringa SQL da cui ricavare il recordset.
Utilizzo: per estrapolare la lista degli utenti del sito generato con ASP Nuke č sufficiente utilizzare questo codice:
<%
Set oCn = DBConnexion(“main”)
rSQL = “Select uLogin from users”
Set oRs = DBRecordset oCn, rSQL
Do while not oRs.EOF
Response.Write oRs(“uLogin”) & “<br%>”
Loop
oRs.Close
Set oRs = Nothing
OCn.Close
Set oCn = Nothing
%>
Anche nel caso di DBRecordset č necessaria la chiusura del recordset.
La funzione č ritrovabile nel file <Root>/includes/database-inc.asp.
DBExecute (oCn, rSQL)La funzione DBExecute permette di eseguire direttamente una query sulla connessione al database.
La funzione accetta come parametri il nome della connessione e la stringa SQL da eseguire.
Utilizzo: per modificare il ruolo di un utente del sito generato con ASP Nuke č sufficiente utilizzare questo codice:
<%
Set oCn = DBConnexion(“main”)
rSQL = “Update users set uRole=2 where uLogin=’Felice’”
DBExecute oCn, rSQL
OCn.Close
Set oCn = Nothing
%>
La funzione č ritrovabile nel file <Root>/includes/database-inc.asp.
SQLEncrypt (sText)La funzione SQLEncrypt permette di modificare una stringa per renderla compatibile con il linguaggio SQL, in modo da non ottenere errori nelle query SQL sui database.
La funzione accetta come parametro la stringa da processare e restituisce come risultato una stringa depurata dalle imperfezioni che spesso causa l’utilizzo degli apici nelle query SQL.
Utilizzo: per rendere compatibile il contenuto di una news con lo standard SQL č possibile utilizzare questo codice, ammettendo che sText provenga da un form ed abbia questo valore:
sText = “All’indomani dell’attacco alle Twin Towers…”
<%
sText = Request.form(“NewsBody”)
Response.Write SQLEncrypt(sText)
%>
Il codice restituira a video la seguente stringa:
All’’indomani dell’’attacco alle Twin Towers…
che č SQL-compatibile.
La funzione č ritrovabile nel file <Root>/includes/database-inc.asp.