ASP Quick Reference

Mula sa CodeW3C.com na mabilis na referensya para sa ASP. Iprint, ilagay sa bulsa, at magamit anumang panahon.

Bastang语法

ASP na script ay nakapalibot ng <% at %> . Ganito na maglilipat ng nilalaman sa browser:

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

Ang default na wika sa ASP ay VBScript. Kung gusto mong gamitin ang ibang script language, maglagay ng isang declaration ng wika sa itaas ng pahina ng ASP:

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

Form at User Input

Request.QueryString ay ginagamit upang kumpilin ang halaga ng form na may method="get". Ang impormasyon na ipinapadala sa pamamagitan ng GET ay nakikita ng lahat (maipapakita sa address bar ng browser), may limitasyon din ang dami ng impormasyon na ipapadala.

Request.Form ay ginagamit upang kumpilin ang halaga ng form na may method="post". Ang impormasyon na ipinapadala sa pamamagitan ng POST mula sa form ay hindi nakikita ng iba, walang limitasyon sa dami ng impormasyon na ipapadala.

ASP Cookies

Ang cookie ay ginagamit upang makilala ang user. Ang cookie ay isang maliit na file na inilagay ng server sa kompyuter ng user. Pagbubukas ng parehong kompyuter sa pamamagitan ng browser upang humingi ng anumang pahina, ang cookie ay dinadala.

Ang command na Response.Cookies ay ginagamit upang bumuo ng cookie:

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

Mga paalala: Ang command na Response.Cookies ay dapat nasa bago ng <html> tag!

"Request.Cookies" command ay ginagamit upang makuha ang halaga ng cookie:

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

Pagsusuri ng File

Sa pamamagitan ng #include instruction, masisama mo ang nilalaman ng isang ASP file sa ibang ASP file bago ito ay ipatupad ng server. Ang #include instruction ay ginagamit upang bumuo ng function, header, footer, o mga elemento na ginagamit sa maraming pahina.

Gramata:

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

o

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

Mangyaring gamitin ang keyword na virtual upang sabihin na ang path ay nagsisimula sa isang virtual directory. Kung ang file na may pangalan na "header.inc" ay nasa virtual directory na may pangalan na /html, ang sumusunod na code ay maglalagay ng nilalaman ng "header.inc":

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

Gamitin ang palatandaan 'file' upang sabihin ang relatibong linya. Ang relatibong linya ay nagsisimula sa direktoryo na naglalaman ng file na binabanggit. Kung ang iyong file ay nasa html direktoryo at ang file 'header.inc' ay nasa html\headers, ang sumusunod na code ay maglalagay ng nilalaman ng 'header.inc' sa iyong file:

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

Gamitin ang palatandaan 'file' at ang syntax (..\) upang tumutukoy sa mga file na nasa mas mataas na antas ng direktoryo.

Global.asa

Ang Global.asa file ay opsyonal, puwedeng maglalaman ng mga deklarasyon ng bagay, variable at paraan na puwedeng ma-access ng bawat pahina ng ASP application.

Komento: Ang Global.asa file ay dapat na nakatago sa root directory ng ASP application, at ang bawat application ay puwedeng magkaroon lamang ng isang Global.asa file.

Ang Global.asa file ay puwedeng maglalaman ng:

  • Application Events
  • Session Events
  • <object> Deklarasyon
  • TypeLibrary Declarasyon
  • Mga #include Instruction

Application at Session Events

Sa Global.asa, maaari mong sabihin kung ano ang gagawin ng application at session object kapag nag-uumpisa o nagtapos ang application/session. Ang code na gagawin ay nasa event handler.

Komento: Sa pag-ipon ng code sa Global.asa file, hindi namin gumagamit ng <% at %> - kailangan nating ilagay ang mga subprograma sa loob ng HTML <script> tag:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' ang ilang code
end sub
sub Application_OnEnd
  ' ang ilang code
end sub
sub Session_OnStart
  ' ang ilang code
end sub
sub Session_OnEnd
  ' ang ilang code
end sub
</script>

<object> Deklarasyon

Sa pamamagitan ng paggamit ng <object> tag, maaari ring lumikha ng mga bagay na may session o application scope sa Global.asa.

Komento: Ang <object> tag ay dapat na nasa labas ng <script> tag!

Gramata:

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

TypeLibrary Declarasyon

Ang TypeLibrary ay isang container ng nilalaman ng DLL file na katulad sa COM object. Sa pamamagitan ng paglaman ng pagtawag sa TypeLibrary sa Global.asa file, magiging makakapasok ka sa mga constant ng COM object, at ang ASP code ay magiging magaling pang ulat ng error. Kung ang iyong web application ay umaasa sa COM object na na-deklara sa typelibrary, maaring i-deklara mo ang typelibrary sa Global.asa.

Gramata:

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

Session object

Ang Session object ay ginagamit upang imbakin ang impormasyon tungkol sa session ng user o baguhin ang mga setting nito. Ang mga variable na imbakin sa Session object ay naglalaman ng impormasyon tungkol sa isang user at maaring ma-access ng lahat ng pahina ng aplikasyon.

collection

  • Contents - Naglalaman ng lahat ng mga entry na idinagdag sa session sa pamamagitan ng utos ng script
  • StaticObjects - Naglalaman ng lahat ng mga object na idinagdag sa session gamit ang <object> tag sa HTML
  • Contents.Remove(item/index) - Alisin ang isang item mula sa Contents collection
  • Contents.RemoveAll() - Alisin ang lahat ng mga item mula sa Contents collection

property

  • CodePage - Tumutukoy sa charset na ginagamit sa pagpapakita ng dinamikong nilalaman
  • LCID - Itatag ang region identifier na ginagamit sa pagpapakita ng dinamikong nilalaman
  • SessionID - Ibabalik ang session id
  • Timeout - Itatag o ibabalik ang oras ng pagkakaroon ng session na walang ginagawa

method

  • Abandon - Iwawalang-bahagya ang lahat ng mga object sa session object.

Application object

Ang grupo ng ASP na nagtutulungan upang tapusin ang isang gawain ay tinatawag na isang aplikasyon. Ang Application object sa ASP ay ginagamit upang ipagsama ang mga file. Lahat ng mga user ay magbabanggit ng isang Application object. Ang Application object ay dapat magkaroon ng impormasyon na ginagamit ng maraming pahina ng aplikasyon (halimbawa, impormasyon ng koneksyon sa database).

collection

  • Mga nilalaman - Naglalaman ng lahat ng mga proyekto na idinagdag sa aplikasyon sa pamamagitan ng utos ng script
  • StaticObjects - Naglalaman ng lahat ng mga object na idinagdag sa application gamit ang <object> tag sa HTML
  • Contents.Remove - Itatanggal ang isang item mula sa koleksyon ng Contents
  • Contents.RemoveAll - Itatanggal ang lahat ng mga item mula sa koleksyon ng Contents

method

  • Lock - Pinapigilan ang user na baguhin ang mga variable sa object ng Application
  • Unlock - Pinapahintulutan ang user na baguhin ang mga variable sa object ng Application

Response object

Response object ay ginagamit upang ipapadala ang output mula sa server sa user.

collection

Cookies(name) - Itatatakbo ang halaga ng cookie. Kung wala ito, itatayo ang cookie at itatatakbo ang tinukoy na halaga.

property

  • Buffer - Itatatakbo kung dapat ibuffer ang output. Kapag ang output ay naka-set sa cache, ang server ay ipagbawal ang sagot sa browser hanggang ang lahat ng server script ay napaproseso, o hanggang ang script ay tinawag ang Flush o End method. Kung ito ay dapat naka-set, ito ay dapat nasa unahan ng <html> tag sa .asp file.
  • CacheControl - Itatatakbo kung maaaring magcache ang proxy server ng output na ginawa ng ASP. Kung ito ay naka-set bilang Public, ang proxy server ay gagawa ng cache ng pahina.
  • Charset(charset_name) - Magdagdag ng pangalan ng charset sa header ng content-type ng object na sagot.
  • ContentType - Itatatakbo ang HTTP content type ng object na sagot (halimbawa "text/html", "image/gif", "image/jpeg", "text/plain"). Ang default ay "text/html"
  • Expires - Itatatakbo ang oras ng cache ng browser bago ito magiging hindi maaring gamitin (minuto)
  • ExpiresAbsolute - Itatatakbo ang petsa at oras ng pagsasanggalang ng cache ng browser
  • IsClientConnected - Nagtutukoy kung nakabit ang client mula sa server
  • Pics(pics_label) - Magdagdag ng halaga sa PICS flag sa header ng response
  • Status - Tumutukoy sa halaga ng status line na ibabalik ng server

method

  • AddHeader(name, value) - Magdagdag ng bagong HTTP header at halaga sa HTTP sagot
  • AppendToLog string - Magdagdag ng string sa katapusan ng server log entry
  • BinaryWrite(data_to_write) - Write data directly to the output without any character conversion
  • Clear - Clear buffered output. Use this method to handle errors. If Response.Buffer is not set to true, this method will produce a run-time error
  • End - Stop processing the script and return the current result
  • Flush - Send cached output immediately. If Response.Buffer is not set to true, this method will produce a run-time error
  • Redirect(url) - Redirect the user to another URL
  • Write(data_to_write) - Write text to the user

Request object

When the browser requests a page from the server, it is called a request. The request object is used to obtain information from the user.

collection

  • ClientCertificate - Contains the values of fields stored in the client certificate
  • Cookies(name) - Contains cookie values
  • Form(element_name) - Contains form values. This form must use the POST method
  • QueryString(variable_name) - Contains the values of variables in the query string
  • ServerVariables(server_variable) - Contains the value of server variables

property

  • TotalBytes - Return the total number of bytes sent by the client in the request body

method

  • BinaryRead - Retrieve data sent from the client to the server as part of a POST request

Server object

The Server object is used to access properties and methods on the server.

property

ScriptTimeout - Set or return how long a script can run before it is terminated.

method

  • CreateObject(type_of_object) - Create an instance of an object
  • Execute(path) - Execute another ASP file from within an ASP file. Control is returned to the original ASP file after the called ASP file has finished executing
  • ) - Return an ASPError object that describes the error that occurred
  • HTMLEncode(string) - Apply HTML encoding to a string
  • MapPath(path) - Map relative or virtual path to physical path
  • Transfer(path) - Send all status information to another file for processing. After transmission, control of the program will not return to the original ASP file
  • URLEncode(string) - Apply URL encoding rules to strings

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