Rujukan Cepat ASP

Rujukan Cepat ASP daripada CodeW3C.com. Cetak dan masukkan ke dompet, untuk digunakan sewaktu memerlukan.

Sintaks Dasar

Skrip ASP dihalalkan oleh <% dan %> mengelilingi. Bagaimana mengeluarkan kandungan kepada pelayar:

<html>
<body>
<% responsenulis("Hello World!") %>
</body>
</html>

ASP 中的默认语言是 VBScript。如需使用其他脚本语言，请在 ASP 页面顶端插入一段语言声明：

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

表单和用户输入

Request.QueryString 用户收集 method="get" 的表单中的值。从表单通过 GET 发送的信息对所有人都可见（将显示在浏览器的地址栏中），对所发送的数据量也有限制。

Request.Form 用于收集 method="post" 的表单中的值。从表单通过 POST 发送的信息对其他人是不可见，对所发送的数据量没有限制。

Cookies ASP

cookie 常用语识别用户。cookie 是服务器嵌到用户计算机上的小文件。每当相同的计算机通过浏览器请求摸个页面时，也会发送 cookie。

Response.Cookies 命令用于创建 cookie：

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

注释：Response.Cookies 命令必须位于 <html> 标签之前！

"Request.Cookies" 命令用于取回 cookie 值：

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

引用文件

通过 #include 指令，在服务器执行前，您能够把一个 ASP 文件的内容插入另一个 ASP 文件中。#include 指令用于创建函数、页头、页脚，或多个页面上重复使用的元素。

Sintaks:

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

或者

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

请使用关键词 virtual 来指示以虚拟目录开始的路径。如果名为 "header.inc" 的文件位于名为 /html 的虚拟目录中，那么下面的代码会插入 "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> 声明
  • Pengumuman 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> 标签之外！

Sintaks:

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

Pengumuman TypeLibrary

TypeLibrary adalah wadah konten file DLL yang sejalan dengan objek COM. Dengan memasukkan panggilan TypeLibrary ke file Global.asa, dapat diakses konstanta objek COM, serta kode ASP dapat melaporkan kesalahan lebih baik. Jika aplikasi web Anda menggantung objek COM yang telah dideklarasikan dalam type library, Anda dapat mengumumkan type library di Global.asa.

Sintaks:

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

Objek Session

Objek Session digunakan untuk menyimpan informasi tentang session pengguna atau mengubah pengaturannya. Variabel yang disimpan dalam objek Session mengandungi informasi tentang pengguna tunggal dan dapat diakses oleh semua halaman dalam aplikasi.

Kumpulan

  • Contents - Mengandungi semua entri yang ditambahkan ke session melalui perintah skrip
  • StaticObjects - Mengandungi semua objek yang ditambahkan ke session melalui tag <object> HTML
  • Contents.Remove(item/index) - Menghapus satu item dari kumpulan Contents
  • Contents.RemoveAll() - Menghapus semua item dari kumpulan Contents

Sifat

  • CodePage - Menentukan charset yang digunakan untuk menampilkan konten dinamik
  • LCID - Mengatur identifikasi wilayah yang digunakan untuk menampilkan konten dinamik
  • SessionID - Mengembalikan id session
  • Timeout - Mengatur atau mengembalikan masa habis session

Kemudahan

  • Abandon - Menarik semula semua objek dalam objek session.

Objek Application

Sebuah kumpulan file ASP yang bekerja bersama untuk menyelesaikan tugas disebut aplikasi. Objek Application di ASP digunakan untuk mengikat file-fil tersebut bersama. Semua pengguna mengikat satu objek Application. Objek Application harus mengandungi informasi yang digunakan oleh banyak halaman dalam aplikasi (seperti informasi koneksi database).

Kumpulan

  • Kandungan - Mengandungi semua objek yang ditambahkan ke aplikasi melalui perintah skrip
  • StaticObjects - Mengandungi semua objek yang ditambahkan ke aplikasi dengan tag <object> HTML
  • Contents.Remove - Buang satu item daripada kumpulan Contents
  • Contents.RemoveAll - Buang semua item daripada kumpulan Contents

Kemudahan

  • Lock - Menghalang pengguna untuk mengubah variabel dalam objek Application
  • Unlock - Memungkinkan pengguna untuk mengubah variabel dalam objek Application

Objek Response

Objek Response digunakan untuk menghantar output dari pelayan ke pengguna.

Kumpulan

Cookies(name) - Tetapkan nilai cookie. Jika tiada, buat cookie baru dan tetapkan nilai yang ditetapkan.

Sifat

  • Buffer - Tentukan sama ada output dihalangkan. Apabila output diatur di halangkan, pelayan akan menghalangkan tanggapan kepada pelayar sehingga semua skrip pelayan disemak, atau sehingga skrip memanggil Flush atau End method. Jika hendak mengatur sifat ini, ia sepatutnya berada di sebelum tag <html> dalam fail .asp.
  • CacheControl - Tetapkan sama ada pelayan seimbang boleh menyimpan output yang dihasilkan oleh ASP. Jika diatur Public, pelayan seimbang akan menyimpan halaman.
  • Charset(charset_name) - Menambahkan nama charset ke header content-type objek tanggapan.
  • ContentType - Tetapkan jenis konten HTTP objek tanggapan. (contohnya "text/html", "image/gif", "image/jpeg", "text/plain"). Lengkapnya adalah "text/html"
  • Expires - Tetapkan masa pengecapan pengecapan pelayar untuk halaman sebelum ia rosak (dalam minit)
  • ExpiresAbsolute - Tetapkan tarikh dan masa berlaku pengecapan halaman pelayar
  • IsClientConnected - Menandakan apakah klien sudah putus koneksi dari server
  • Pics(pics_label) - Menambahkan nilai ke tanda PICS di header tanggapan
  • Status - Tentukan nilai baris status yang dikembalikan oleh server

Kemudahan

  • AddHeader(name, value) - Menambahkan header baru dan nilai HTTP ke tanggapan HTTP
  • AppendToLog string - Menambahkan string ke akhir pendaftaran projek ke server (server log entry)
  • BinaryWrite(data_to_write) - Menulis data ke output tanpa konversi sebarang aksara
  • Clear - Menghapus output yang disimpan. Gunakan kaedah ini untuk mengatasi kesalahan. Jika Response.Buffer belum diatur kepada true, kaedah ini akan menghasilkan kesalahan masa pengoperasian
  • End - Berhenti mengendalikan skrip, dan mengembalikan hasil semasa
  • Flush - Menghantar output yang disimpan ke sebelah dalam masa sekarang. Jika Response.Buffer belum diatur kepada true, kaedah ini akan menghasilkan kesalahan masa pengoperasian
  • Redirect(url) - Mengalihkan pengguna ke URL lain
  • Write(data_to_write) - Menulis teks kepada pengguna

Objek Permintaan

Ketika perpustakaan pereka daripada pelayan untuk halaman, ia disebut permintaan. Objek permintaan digunakan untuk mendapatkan maklumat dari pengguna.

Kumpulan

  • ClientCertificate - Mengandungi nilai medan yang disimpan dalam sertifikat pelanggan
  • Cookies(name) - Mengandungi nilai cookie
  • Form(element_name) - Mengandungi nilai form. Form mesti digunakan dengan kaedah post
  • QueryString(variable_name) - Mengandungi nilai variabel dalam string permintaan
  • ServerVariables(server_variable) - Mengandungi nilai variabel pelayan

Sifat

  • TotalBytes - Mengembalikan jumlah byte yang dihantar oleh klien dalam isian permintaan

Kemudahan

  • BinaryRead - Mengembalikan data yang dihantar dari klien ke pelayan sebagai sebahagian daripada permintaan post

Objek Server

Objek Server digunakan untuk mengakses sifat dan kaedah di atas pelayan.

Sifat

ScriptTimeout - Menetapkan atau mengembalikan masa yang dapat dijalankan oleh skrip sebelum dihentikan.

Kemudahan

  • CreateObject(type_of_object) - Membuat instansiasi objek
  • Execute(path) - Melaksanakan ASP lain dari dalam fail ASP. Dalam mengambil alih fail ASP yang dipanggil, kawalan kembali kepada fail ASP asal
  • ) - Mengembalikan objek ASPError yang mendeskripsikan kesalahan yang terjadi
  • HTMLEncode(string) - Melaksanakan pengkodan HTML kepada string
  • MapPath(path) - Memapkan laluan relatif atau maya ke laluan fizikal
  • Transfer(path) - Mengirimkan semua informasi status ke berkas lain untuk diproses. Setelah pengiriman, kontrol program tidak akan kembali ke berkas ASP asli
  • URLEncode(string) - Terapkan aturan enkoding URL untuk kalimat

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