ایس پی چوتن

مرجع سریع ASP از CodeW3C.com. چاپ کنید، در جیب خود نگه دارید و همیشه آماده باشید.

زبان پایه

اسکریپت‌های اچ‌تی‌ام‌ال از <% و %> احاطه می‌شوند. به این صورت محتوا را به مرورگر ارسال می‌کنید:



<% رپلایس ورد (\

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

<%@ language="javascript" %>


<%
....
%>

表单和用户输入

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

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

ایس پی کوکیز

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

Response.Cookies 命令用于创建 cookie：

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

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

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

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

引用文件

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

تعریف TypeLibrary

或者

请使用关键词 virtual 来指示以虚拟目录开始的路径。如果名为 "header.inc" 的文件位于名为 /html 的虚拟目录中，那么下面的代码会插入 "header.inc" 的内容：

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

استخدم كلمة المفتاح file لتعريف المسار النسبي. المسار النسبي يبدأ بمجلد يحتوي على الملف المشار إليه في الملف المرفق.

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

استخدم كلمة المفتاح file والنحو (..\) لتعريف ملفات الأعلى مستوى في المسار.

Global.asa

ملف Global.asa هو ملف اختياري يمكن أن يحتوي على بيانات يمكن الوصول إليها من كل صفحة في تطبيق ASP، مثل بيانات الاشارة، المتغيرات والطرق.

تعليق: يجب أن يكون ملف Global.asa موجودًا في مجلد الجذر لبرنامج ASP، ويمكن لكل تطبيق أن يحتوي على ملف Global.asa واحد فقط.

يمكن أن تحتوي ملفات Global.asa فقط على ما يلي:

  • أحداث Application
  • أحداث Session
  • <object> الاشارة
  • ......
  • تعليمات #include

أحداث Application و Session

في Global.asa، يمكنك إخبار كائنات application و session بما يجب القيام به عند بدء application/session، وما يجب القيام به عند إنتهاء application/session. يقع كود هذه المهمة في معالج الأحداث.

تعليق: عند إدراج كود في ملف Global.asa، لا نستخدم <% و %>، نحن نضع البرامج في داخل علامة <script> من HTML:

<script language="vbscript" runat="server">
sub Application_OnStart
  ' بعض الكود
end sub
sub Application_OnEnd
  ' بعض الكود
end sub
sub Session_OnStart
  ' بعض الكود
end sub
sub Session_OnEnd
  ' بعض الكود
end sub
</script>

<object> الاشارة

باستخدام علامة <object>، يمكنك أيضًا إنشاء كائنات بـ Global.asa تحتوي على نطاق session أو application.

تعليق: <object> العلامة يجب أن تكون خارج <script> العلامة!

تعریف TypeLibrary

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

......

</object>

تعریف TypeLibrary

TypeLibrary یک جعبه محتواست که شامل DLL فایل‌های مربوط به COM objects است. با درج فراخوانی TypeLibrary در فایل Global.asa، می‌توان به متغیرهای ثابت objects COM دسترسی پیدا کرد و کد ASP نیز می‌تواند خطاهای بهتر را گزارش دهد. اگر برنامه وب شما از objects COM که در نوع library مشخص شده‌اند استفاده می‌کند، می‌توانید آن نوع library را در Global.asa معرفی کنید.
قوانین:
<!--
METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="versionnumber"

lcid="localeid"

-->

مجموعه

  • Session object
  • Session object برای ذخیره اطلاعات مربوط به session کاربر و یا تغییر تنظیمات آن استفاده می‌شود. متغیرهای موجود در object session اطلاعات مربوط به یک کاربر خاص را دارند و می‌توانند توسط همه‌ی صفحات یک برنامه دسترسی پیدا کنند.
  • Contents - شامل همه‌ی ورودی‌هایی که از طریق دستورات اسکریپت به session اضافه می‌شوندStaticObjects - شامل همه‌ی اشیاء که از طریق برچسب <object> HTML به session اضافه شده‌اندContents.Remove(item/
  • index

ویژگی

  • ) - یک پروژه را از مجموعه Contents حذف می‌کند
  • Contents.RemoveAll() - همه‌ی پروژه‌ها را از مجموعه Contents حذف می‌کند
  • CodePage - مجموعه‌ای از کاراکترها را که برای نمایش محتوای پویا استفاده می‌شود، مشخص می‌کند
  • LCID - شناسه منطقه‌ای را که برای نمایش محتوای پویا استفاده می‌شود، تنظیم می‌کند

مетод

  • SessionID - شناسه session را بازگرداند

Timeout - زمان انقضای session را تنظیم یا بازگرداند

یک مجموعه از فایل‌های ASP که برای تکمیل یک وظیفه با هم کار می‌کنند، یک برنامه نامیده می‌شود. فراموش کردن - همه‌ی اشیاء موجود در session object را لغو می‌کند.

مجموعه

  • مقصد - شامل تمامی پروژه‌هایی که از طریق دستورات اسکریپت به برنامه اضافه می‌شوند
  • StaticObjects - سارے <object> آئیکنوگرام کو HTML کے ذریعے ایپلیکیشن میں اضافہ کئے گئے آئیٹموں کا مجموعہ شامل کیا جاتا ہے
  • Contents.Remove - ایک آئیٹم کو Contents مجموعے سے مٹا دینا
  • Contents.RemoveAll - سارے آئیٹموں کو Contents مجموعے سے مٹا دینا

مетод

  • Lock - یوزر کو ایپلیکیشن آوبجیکٹ میں متغیروں میں ترمیم کرنے سے روکنا
  • Unlock - یوزر کو ایپلیکیشن آوبجیکٹ میں متغیروں میں ترمیم کرنے کی اجازت دینا

Response آوبجیکٹ

Response آوبجیکٹ سرور سے پُٹ کو یوزر کو ارسال کرنا کے لئے استعمال کیا جاتا ہے

مجموعه

Cookies(name) - کیچ کی قیمتی سیٹ کرنا یا اگر نہیں موجود تو نئی کیچ کی قیمتی سیٹ کرنا، پھر مخصوص قیمتی سیٹ کرنا

ویژگی

  • Buffer - اضافہ کرنا کیا جائے کہ آؤٹ پُٹ کا بوفر سیٹ کیا جائے یا نہیں۔ جب آؤٹ پُٹ کا بوفر سیٹ کیا گیا تو سرور ویب سیریئل سے رپوزنسی نہیں دے سکتا تاکہ تمام سرور اسکریپٹس کا پروسیسنگ مکمل ہو یا تک کہ اسکریپٹ نے Flush یا End کا کارروائی کیا ہو، اگر یہ اپریشن سیٹ کیا جائے تو یہ اپریشن <html> آئیکنوگرام کے پہلے میں سیٹ کیا جائے گا
  • CacheControl - سیفارا سرور کو ASP کی پیداوار کی کیچ میں سیفارا نہیں کرنا یا سیفارا کرنا سیٹ کرنا۔ اگر یہ پبلک سیٹ کیا گیا تو سیفارا سرور ویب پیج کو سیفارا کر سکتا ہے
  • Charset(charset_name) - چارکٹ سیٹ کی نام کو رپوزنسی آوبجیکٹ کی content-type ہیڈر میں اضافہ کرنا
  • ContentType - رپوزنسی آوبجیکٹ کی HTTP وسیع نوعیت سیٹ کرنا (مثلاً "text/html", "image/gif", "image/jpeg", "text/plain"). میلتیپل سیٹ آپ میں "text/html" ہوتا ہے
  • Expires - ویب پیج کی سیفارا میں کیچ کی مدت سیٹ کرنا (منٹ) قبل سے کچل جائے
  • ExpiresAbsolute - بیورسر کی ویب پیج کی سیفارا میں کیچ کی تاریخی اور وقت کو سیٹ کرنا
  • IsClientConnected - یہ نشان دہ می‌کند کہ کلائنٹ سرور سے کسی بھی طرح سے کچل چکا ہے یا نہیں
  • Pics(pics_label) - رپوزنسی کی ہیڈر کی PICS آئیکنوگرام میں اعداد و شمار کا اضافہ کرنا
  • Status - سرور کی رد کی جائزہ لینے والی لائن کی قیمتی

مетод

  • AddHeader(name, value) - نیا HTTP ہیڈر اور اعداد و شمار HTTP رپوزنسی کی نکلی میں اضافہ کرنا
  • AppendToLog string - اضافہ کرنا سرور پر پروجیکٹ (server log entry) کی کانکری کی نکلی
  • BinaryWrite(data_to_write) - داده‌ها را بدون تغییر در تبدیل کاراکترها به خروجی می‌نویسد
  • Clear - خروجی ذخیره شده را پاک می‌کند. از این روش برای مدیریت خطاها استفاده می‌شود. اگر Response.Buffer به true تنظیم نشده باشد، این روش خطای زمان اجرا ایجاد می‌کند
  • End - پردازش اسکریپت را متوقف می‌کند و نتایج فعلی را برمی‌گرداند
  • Flush - بلافاصله خروجی ذخیره شده را ارسال می‌کند. اگر Response.Buffer به true تنظیم نشده باشد، این روش خطای زمان اجرا ایجاد می‌کند
  • Redirect(url) - کاربر را به یک URL دیگر هدایت می‌کند
  • Write(data_to_write) - متن را به کاربر می‌نویسد

Request object

وقتی که مرورگر درخواست صفحه‌ای از سرور را می‌کند، این درخواست به عنوان request نامیده می‌شود. object request برای دریافت اطلاعات از کاربر استفاده می‌شود.

مجموعه

  • ClientCertificate - شامل مقادیر فیلدهایی است که در گواهینامه مشتری ذخیره شده‌اند
  • Cookies(name) - شامل مقادیر کوکی است
  • Form(element_name) - شامل مقادیر فرم است. این فرم باید از روش POST استفاده کند
  • QueryString(variable_name) - شامل مقادیر متغیرهای جستجو است
  • ServerVariables(server_variable) - شامل مقادیر متغیرهای سرور است

ویژگی

  • TotalBytes - تعداد کل بایت‌هایی که توسط کلاینت در متن درخواست ارسال شده است را برمی‌گرداند

مетод

  • BinaryRead - داده‌هایی که به عنوان بخشی از درخواست POST از کلاینت به سرور ارسال شده‌اند را برمی‌گرداند

Server object

Server object برای دسترسی به ویژگی‌ها و روش‌های سرور استفاده می‌شود.

ویژگی

ScriptTimeout - زمانی که یک اسکریپت می‌تواند قبل از قطع اجرا شود را تنظیم یا برمی‌گرداند.

مетод

  • CreateObject(type_of_object) - نمونه‌ای از یک object ایجاد می‌کند
  • Execute(پتھ) - یک ASP file دیگر را از داخل یک ASP file اجرا می‌کند. پس از اجرای ASP file فراخوانی شده، کنترل به ASP file اصلی بازمی‌گردد
  • ) - ASPError object توصیف‌کننده خطایی که رخ داده است را برمی‌گرداند
  • HTMLEncode(اسٹرنگ) - کد HTML را به یک رشته اعمال می‌کند
  • MapPath(پتھ) - مپنگ مسیر فیزیکی از مسیرهای مطلق یا مجازی
  • Transfer(پتھ) - تمام حالیاتی معلومات کو دوسرے فائل میں بھیجنا، تاکہ بعد میں معالجہ کیا جاسکے۔ بھیجائی جانے کے بعد، پروگرام کا کنٹرول ایس پی فائل پر واپس نہیں آتا
  • URLEncode(اسٹرنگ) - یورل اعداد اشاریوں کی کارکردگی کا استعمال کرتا ہے

مقصد: http://www.codew3c.com/asp/asp_quickref.asp