ASP nopea viittaus

CodeW3C.com:n ASP nopea tarkistus. Tulosta ja laita taskuun, valmiina käyttöön.

Peruskieli

ASP-skripti on <% ja %> sisällä. Tämä lähettää sisältöä selaimelle:

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

ASP:n oletuskieli on VBScript. Jos haluat käyttää muuta skriptikieltä, lisää ASP-sivun ylätunnisteeseen kielen määrittely:

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

Lomakkeet ja käyttäjän syötteet

Request.QueryString käytetään method="get" -menetelmän mukaisen lomakkeen arvojen keräämiseen. Lomakkeella GET-menetelmällä lähetetyn tiedon näkevät kaikki, ja tiedon määrällä on rajoituksia (näytetään selaimen osoiterivillä).

Request.Form käytetään method="post" -menetelmän mukaisen lomakkeen arvojen keräämiseen. Lomakkeella POST-menetelmällä lähetetyn tiedon näkevät vain lähettäjä, eikä tiedon määrällä ole rajoituksia.

ASP evästeet

Cookieta käytetään käyttäjän tunnistamiseen. Cookie on pieni tiedosto, jonka palvelin lisää käyttäjän tietokoneeseen. Kun sama tietokone pyytää tiettyä sivua selaimen kautta, se lähettää myös cookien.

Response.Cookies -komento käytetään cookieta luomaan:

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

Huomautus: Response.Cookies -komento täytyy olla <html>-tagin sisällä!

"Request.Cookies" -komento käytetään cookie-arvojen palauttamiseen:

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

Tiedoston viittaus

Käyttämällä #include -komentoa voit sisällyttää ASP-tiedoston sisällön toiseen ASP-tiedostoon ennen kuin palvelin suorittaa sen. #include -komento käytetään funktioiden, sivun otsikon, alatunnisteen tai useiden sivujen toistuvien elementtien luomiseen.

Syntaksi:

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

tai

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

Käytä avainsanaa virtual ilmaistaksesi polun, joka alkaa virtuaalikansiosta. Jos tiedosto nimeltä "header.inc" sijaitsee virtuaalikansiossa /html, seuraava koodi lisää "header.inc" -tiedoston sisällön:

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

Käytä avainsanaa file osoittaaaksesi suhteellisen polun. Suhteellinen polku alkaa hakemistosta, joka sisältää viittaustiedoston. Jos tiedosto sijaitsee html-kansiossa ja tiedosto "header.inc" sijaitsee html\headers -kansiossa, seuraava koodi lisää "header.inc" -tiedoston sisällön tiedostoonsi:

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

Käytä avainsanaa file ja syntaxia (..\) viitataksesi korkeammalle tasoiselle hakemistolle.

Global.asa

Global.asa -tiedosto on valinnainen tiedosto, joka voi sisältää objektille, muuttujille ja menetelmille, joita ASP-sovelluksen kaikki sivut voivat käyttää.

Kommentti: Global.asa -tiedosto täytyy sijaita ASP-sovelluksen juurikansiossa, ja jokaisessa sovelluksessa voi olla vain yksi Global.asa -tiedosto.

Global.asa -tiedosto voi sisältää vain seuraavaa sisältöä:

  • Application -tapahtumat
  • Session -tapahtumat
  • <object> -ilmoitus
  • TypeLibrary-määrittely
  • #include -ohje

Application- ja Session -tapahtumat

Global.asa -tiedostossa voit määritellä, mitä application- ja session-objektit tekevät, kun application/session alkaa ja loppuu. Tämä tehtävä suoritetaan tapahtumankäsittelijöissä.

Kommentti: Kun lisätään koodia Global.asa -tiedostoon, emme käytä <% ja %>, vaan asetetaan aliohjelmat HTML <script> -elementin sisälle:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' jokin koodi
end sub
sub Application_OnEnd
  ' jokin koodi
end sub
sub Session_OnStart
  ' jokin koodi
end sub
sub Session_OnEnd
  ' jokin koodi
end sub
</script>

<object> -ilmoitus

Käyttämällä <object> -elementtiä, voit myös luoda session- tai application-ala-objekteja Global.asa -tiedostossa.

Kommentti: <object> -elementti tulisi olla <script> -elementin ulkopuolella!

Syntaksi:

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

TypeLibrary-määrittely

TypeLibrary on DLL-tiedoston sisältö, joka vastaa COM-objektia. Global.asa-tiedostoon sisällyttämällä TypeLibrary-kutsun voi käyttää COM-objektin vakioita, ja ASP-koodi voi raportoida virheitä paremmin. Jos Web-sovelluksesi riippuu COM-objekteista, jotka on määritelty tyypplibarissa, voit määritellä kyseisen tyypplibarin Global.asa:ssa.

Syntaksi:

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

Session-objekti

Session-objekti käytetään käyttäjän session tietojen tallentamiseen tai sen asetusten muuttamiseen. Session-objektissa olevat muuttujat sisältävät yksittäisen käyttäjän tietoja ja voivat olla saatavilla sovelluksen kaikilla sivuilla.

Kokoelma

  • Contents - Sisältää kaikki komentojen avulla sessioniin lisätyt kohteet
  • StaticObjects - Sisältää kaikki HTML:n <object>-tagin avulla sessioniin lisätyt objektit
  • Contents.Remove(item/index) - Poistaa yhden kohteen Contents-kokoelmasta
  • Contents.RemoveAll() - Poistaa kaikki kohteet Contents-kokoelmasta

Ominaisuus

  • CodePage - Määrittää merkkikoodipaketti, jota käytetään dynaamisen sisällön näyttämiseen
  • LCID - Asettaa alueidentifikaattorin, jota käytetään dynaamisen sisällön näyttämiseen
  • SessionID - Palauttaa session ID:n
  • Timeout - Asettaa tai palauttaa session aikakatkaisun.

Metodi

  • Abandon - Peruuttaa session-objektin kaikki objektit.

Application-objekti

ASP-tiedostojen ryhmä, joka työskentelee yhdessä tavoitteen saavuttamiseksi, kutsutaan sovellukseksi. ASP:n Application-objekti käytetään näiden tiedostojen yhdistämiseen. Kaikki käyttäjät yhdistävät yhden Application-objektin. Application-objektiin tulisi tallentaa tietoa, jota sovelluksen monet sivut käyttävät (esimerkiksi tietokantayhteyden tiedot).

Kokoelma

  • Sisältö - sisältää kaikki komentojen avulla sovellukseen lisätyt projektit
  • StaticObjects - Sisältää kaikki HTML:n <object>-tagin avulla sovellukseen lisätyt objektit
  • Contents.Remove - Poistaa yhden kohteen Contents-kokoelmasta
  • Contents.RemoveAll - Poistaa kaikki kohteet Contents-kokoelmasta

Metodi

  • Lock - Estää käyttäjän muokkaamasta Application-objektin muuttujia
  • Unlock - Sallii käyttäjän muokata Application-objektin muuttujia

Response-objekti

Response-objekti käytetään lähettämään tietoja käyttäjälle palvelimelta.

Kokoelma

Cookies(name) - Asettaa cookien arvon. Jos sitä ei ole olemassa, luodaan cookie ja asetetaan määritetty arvo.

Ominaisuus

  • Buffer - Määrittää, onko ulostulo varastoitu. Kun ulostulo asetetaan varastoitavaksi, palvelin estää vastauksen lähettämisen selaimelle, kunnes kaikki palvelinskriptit on käsitelty tai kun skripti on kutsunut Flush- tai End-metodia. Jos haluat asettaa tämän ominaisuuden, se tulisi sijoittaa .asp-tiedoston <html>-tagin eteen.
  • CacheControl - Asettaa, voidaako välityspalvelin välimuistittaa ASP:stä tuotetun tuloksen. Jos asetetaan Public, välityspalvelin välimuistittaa sivua.
  • Charset(charset_name) - Lisää merkkikansion nimen Response-objektin content-type-otsakkeeseen
  • ContentType - Asettaa Response-objektin HTTP-sisältötyypin. Esimerkiksi "text/html", "image/gif", "image/jpeg", "text/plain". Oletus on "text/html"
  • Expires - Asettaa sivun välimuistinnan päättymisajan selaimessa (minuutit)
  • ExpiresAbsolute - Asettaa selaimen sivun välimuistinnan päättymispäivän ja -ajan
  • IsClientConnected - Ilmoittaa, onko asiakas irrotettu palvelimesta
  • Pics(pics_label) - Lisää arvon PICS-lipulle response-otsakkeeseen
  • Status - Määrittää palvelimen palauttaman tilarivin arvon

Metodi

  • AddHeader(name, arvo) - Lisää uusi HTTP-otsake ja arvo HTTP-vastaukseen
  • AppendToLog string - Lisää merkkijono palvelimen projektiin (palvelimen lokimerkintä)
  • BinaryWrite(data_to_write) - Kirjoittaa suoraan ulostuloon ilman merkkijonon muunnosta
  • Clear - Poistaa varastoidun ulostulon. Käytä tätä menetelmää virheiden käsittelyyn. Jos Response.Buffer ei ole asetettu trueksi, tämä menetelmä aiheuttaa ajon aikaisen virheen
  • End - Pysäyttää skriptin käsittelyn ja palauttaa nykyisen tuloksen
  • Flush - Lähettää välittömästi varastoidun ulostulon. Jos Response.Buffer ei ole asetettu trueksi, tämä menetelmä aiheuttaa ajon aikaisen virheen
  • Redirect(url) - Uudelleenohjaa käyttäjän toiseen URL-osoitteeseen
  • Write(data_to_write) - Kirjoittaa tekstin käyttäjälle

Request-objekti

Kun selain pyytää sivua palvelimelta, tätä kutsutaan pyynnöksi. Request-objekti käytetään käyttäjän tiedon saamiseen

Kokoelma

  • ClientCertificate - Sisältää kenttien arvot, jotka on tallennettu asiakastodistukseen
  • Cookies(name) - Sisältää evästeiden arvot
  • Form(element_name) - Sisältää lomakkeen arvot. Tämä lomake on käytettävä post-menetelmällä
  • QueryString(variable_name) - Sisältää hakutoiveen muuttujien arvot
  • ServerVariables(server_variable) - Sisältää palvelinmuuttujien arvot

Ominaisuus

  • TotalBytes - Palauttaa kokonaisen määrän bittiä, jotka asiakas on lähettänyt pyynnön sisällössä

Metodi

  • BinaryRead - Palauttaa tiedon, joka on lähetetty asiakkaalta palvelimelle osana post-pyynnön

Server-objekti

Server-objekti käytetään palvelimen ominaisuuksien ja metodioiden pääsyyn

Ominaisuus

ScriptTimeout - Asettaa tai palauttaa ajan, jonka aikana skripti voi suoritua ennen kuin se keskeytetään

Metodi

  • CreateObject(type_of_object) - Luo objektin instanssin
  • Execute(polku) - Suorittaa toisen ASP-tiedoston sisällä ASP-tiedostosta. Kun kutsutun ASP-tiedoston suoritus on valmis, ohjauksen hallinta palautuu alkuperäiseen ASP-tiedostoon
  • ) - Palauttaa ASPError-objektin, joka kuvaa tapahtunutta virhettä
  • HTMLEncode(string) - HTML-koodaa merkkijonon
  • MapPath(polku) - Karttaa suhteellisen tai virtuaalisen polun fyysiseen polkuun
  • Transfer(polku) - Lähetä kaikki tilatiedot toiseen tiedostoon, jotta ne voidaan käsitellä. Lähetettymisen jälkeen ohjelman hallinta ei palaa alkuperäiseen ASP-tiedostoon
  • URLEncode(string) - Käytä URL-koodaus sääntöjä merkkijonolle

Lähde: http://www.codew3c.com/asp/asp_quickref.asp