المرجع السريع لـ ASP
مرجع ASP السريع من W3Schools. اطبعها ، وقم بطيها في جيبك.
النحو الأساسي
البرامج النصية لـ ASP محاطة بـ <٪ و٪>. لكتابة بعض الإخراج إلى المتصفح:
<html>
<body>
<٪ response.write ("Hello World!")٪>
</body>
</html>
اللغة الافتراضية في ASP هي VBScript. لاستخدام لغة برمجة نصية أخرى ، أدخل مواصفة لغة أعلى صفحة ASP:
<٪ @ language = "javascript"٪>
<html>
<body>
<٪
....
٪>
النماذج وإدخال المستخدم
يتم استخدام Request.QueryString لجمع القيم في شكل مع طريقة = "get". المعلومات المرسلة من نموذج باستخدام طريقة GET مرئية للجميع (سيتم عرضها في شريط عنوان المتصفح) ولها حدود على كمية المعلومات التي يجب إرسالها.
Request.Form يستخدم لجمع القيم في شكل مع طريقة = "post". المعلومات المرسلة من نموذج بطريقة POST غير مرئية للآخرين وليس لها حدود على كمية المعلومات التي يجب إرسالها.
ملفات تعريف الارتباط ASP
غالبًا ما يستخدم ملف تعريف الارتباط لتحديد هوية المستخدم. ملف تعريف الارتباط هو ملف صغير يقوم الخادم بتضمينه على كمبيوتر المستخدم. في كل مرة يطلب فيها نفس الكمبيوتر صفحة بها متصفح ، سيرسل ملف تعريف الارتباط أيضًا.
يُستخدم الأمر Response.Cookies لإنشاء ملفات تعريف الارتباط:
<٪
Response.Cookies ("firstname") = "Alex"
Response.Cookies ("firstname"). تنتهي الصلاحية = "May 10،2002"
٪>
ملاحظة: يجب أن يظهر الأمر Response.Cookies قبل علامة <html>!
يتم استخدام الأمر "Request.Cookies" لاسترداد قيمة ملف تعريف الارتباط:
<٪
fname = Request.Cookies ("firstname")
response.write ("Firstname =" & fname)
٪>
بما في ذلك الملفات
يمكنك إدراج محتوى ملف ASP في ملف ASP آخر قبل أن ينفذه الخادم ، باستخدام التوجيه #include. يتم استخدام التوجيه #include لإنشاء وظائف أو رؤوس أو تذييلات أو عناصر ستتم إعادة استخدامها في صفحات متعددة
بناء الجملة:
<! - # include virtual = "somefile.inc" ->
أو
<! - # include file = "somefile.inc" ->
استخدم الكلمة الأساسية الافتراضية للإشارة إلى مسار يبدأ بدليل افتراضي. إذا كان الملف المسمى "header.inc" موجودًا في دليل ظاهري باسم / html ، فإن السطر التالي سيدرج محتويات "header.inc":
<! - #include virtual = "/ html / header.inc" ->
استخدم الكلمة الأساسية للملف للإشارة إلى مسار نسبي. يبدأ المسار النسبي بالدليل الذي يحتوي على ملف بما في ذلك. إذا كان لديك ملف في دليل html ، وكان الملف "header.inc" موجودًا في html \ headers ، فإن السطر التالي سيدرج "header.inc" في ملفك:
<! - #include file = "headers \ header.inc" ->
استخدم الكلمة الأساسية للملف بالصيغة (.. \) لتضمين ملف من دليل ذي مستوى أعلى.
Global.asa
ملف Global.asa هو ملف اختياري يمكن أن يحتوي على تعريفات للكائنات والمتغيرات والطرق التي يمكن الوصول إليها بواسطة كل صفحة في تطبيق ASP.
ملاحظة: يجب تخزين الملف Global.asa في الدليل الجذر لتطبيق ASP ، ويمكن لكل تطبيق أن يحتوي على ملف Global.asa واحد فقط.
يمكن أن يحتوي الملف Global.asa على ما يلي فقط:
- أحداث التطبيق
- أحداث الجلسة
- تعريفات <object>
- إقرارات TypeLibrary
- # تضمين التوجيه
أحداث التطبيق والجلسة
في Global.asa ، يمكنك إخبار كائنات التطبيق والجلسة بما يجب القيام به عند بدء التطبيق / الجلسة وما يجب القيام به عند انتهاء التطبيق / الجلسة. يتم وضع رمز هذا في معالجات الأحداث. ملاحظة: لا نستخدم <٪ و٪> ، لإدخال البرامج النصية في ملف Global.asa ، يتعين علينا وضع الإجراءات الفرعية داخل علامة HTML <script>:
<script language = "vbscript" runat = "server">
التطبيق الفرعي Application_OnStart
'بعض
فرعية نهاية التعليمات البرمجية
Application_OnEnd ' بعض
فرعية نهاية
الكود
الفرعي Session_OnStart 'بعض
فرعية نهاية
الكود
الفرعي Session_OnEnd
' بعض نهاية الكود
الفرعي
</script>
<object> الإعلانات
من الممكن أيضًا إنشاء كائنات بنطاق جلسة أو تطبيق في Global.asa باستخدام علامة <object>. ملاحظة: يجب أن تكون علامة <object> خارج علامة <script>!
بناء الجملة:
<object runat = "server" range = "range" id = "id"
{progid = "progID" | classid = "classID"}>
.......
</object>
إعلانات TypeLibrary
TypeLibrary هي حاوية لمحتويات ملف DLL المطابق لكائن COM. من خلال تضمين استدعاء إلى TypeLibrary في ملف Global.asa ، يمكن الوصول إلى ثوابت كائن COM ، ويمكن الإبلاغ عن الأخطاء بشكل أفضل بواسطة رمز ASP. إذا كان تطبيق الويب الخاص بك يعتمد على كائنات COM التي أعلنت عن أنواع البيانات في مكتبات الأنواع ، فيمكنك إعلان مكتبات الأنواع في Global.asa.
بناء الجملة:
<! - METADATA TYPE = "TypeLib"
file = "filename"
uuid = "typelibraryuuid"
version = "versionnumber"
lcid = "localeid"
->
كائن الجلسة
يتم استخدام كائن Session لتخزين المعلومات أو تغيير الإعدادات لجلسة مستخدم. تحتوي المتغيرات المخزنة في كائن Session على معلومات حول مستخدم واحد ، وهي متاحة لجميع الصفحات في تطبيق واحد.
المجموعات
- المحتويات - يحتفظ بكل عنصر مضاف إلى الجلسة بأوامر البرنامج النصي
- StaticObjects - يحتفظ بكل كائن مضاف إلى الجلسة بعلامة <object> وجلسة معينة
- Contents.Remove ( item / index ) - يحذف عنصرًا من مجموعة المحتويات
- Contents.RemoveAll () - يحذف كل عنصر من مجموعة المحتويات
الخصائص
- CodePage - يضبط صفحة الرموز التي سيتم استخدامها لعرض المحتوى الديناميكي
- LCID - يضبط معرف الإعدادات المحلية الذي سيتم استخدامه لعرض المحتوى الديناميكي
- SessionID - إرجاع معرف الجلسة
- المهلة - يضبط مهلة الجلسة
طريقة
- التخلي - يقتل كل كائن في كائن جلسة
كائن التطبيق
تسمى مجموعة ملفات ASP التي تعمل معًا لأداء بعض الأغراض تطبيقًا. يتم استخدام كائن التطبيق في ASP لربط هذه الملفات معًا. يشترك جميع المستخدمين في كائن تطبيق واحد. يجب أن يحتوي كائن التطبيق على المعلومات التي سيتم استخدامها بواسطة العديد من الصفحات في التطبيق (مثل معلومات اتصال قاعدة البيانات).
المجموعات
- المحتويات - يحتفظ بكل عنصر مضاف إلى التطبيق بأوامر البرنامج النصي
- StaticObjects - يحتفظ بكل كائن مضاف إلى التطبيق بعلامة <object>
- المحتويات. إزالة - حذف عنصر من مجموعة
- Contents.RemoveAll - يحذف كل عنصر من مجموعة
طرق
- قفل - يمنع المستخدم من تغيير خصائص كائن التطبيق
- فتح - يسمح للمستخدم بتغيير خصائص كائن التطبيق
كائن الاستجابة
يتم استخدام كائن الاستجابة لإرسال الإخراج إلى المستخدم من الخادم.
مجموعة
- ملفات تعريف الارتباط (الاسم) - تحدد قيمة ملف تعريف الارتباط. إذا لم يكن ملف تعريف الارتباط موجودًا ، فسيتم إنشاؤه ، وسيأخذ القيمة المحددة
الخصائص
- المخزن المؤقت - سواء كان سيتم تخزين الإخراج أم لا. عندما يتم تخزين الإخراج مؤقتًا ، فإن الخادم سيحجم الاستجابة حتى تتم معالجة جميع البرامج النصية للخادم ، أو حتى يستدعي البرنامج النصي طريقة Flush أو End. إذا تم تعيين هذه الخاصية ، يجب أن تكون قبل علامة <html> في ملف ASP
- CacheControl - يحدد ما إذا كانت الخوادم الوكيلة يمكنها تخزين الإخراج مؤقتًا أم لا. عند التعيين إلى عام ، يمكن تخزين الإخراج مؤقتًا بواسطة خادم وكيل
- مجموعة الأحرف ( charset_name) - لتعيين اسم مجموعة الأحرف (مثل "ISO8859-1") إلى رأس نوع المحتوى
- نوع المحتوى - يضبط نوع محتوى HTTP (مثل "نص / html" ، "صورة / gif" ، "صورة / jpeg" ، "نص / عادي"). الافتراضي هو "text / html"
- انتهاء الصلاحية - يحدد المدة التي سيتم فيها تخزين الصفحة في ذاكرة التخزين المؤقت على المستعرض قبل انتهاء صلاحيتها
- ExpiresAbsolute - يضبط التاريخ والوقت اللذين تنتهي فيهما صلاحية الصفحة المخزنة مؤقتًا على المستعرض
- IsClientConnected - للتحقق مما إذا كان العميل لا يزال متصلاً بالخادم
- Pics ( pics_label ) - يضيف قيمة إلى عنوان استجابة تسمية pics
- الحالة - تحدد قيمة سطر الحالة
طرق
- AddHeader ( الاسم والقيمة ) - يضيف رأس HTML بقيمة محددة
- سلسلة AppendToLog - تضيف سلسلة إلى نهاية إدخال سجل الخادم
- BinaryWrite ( data_to_write ) - يكتب المعلومات المعطاة دون أي تحويل لمجموعة الأحرف
- مسح - يمسح الإخراج المخزن مؤقتًا. استخدم هذه الطريقة لمعالجة الأخطاء. إذا لم يتم تعيين Response.Buffer إلى true ، فستتسبب هذه الطريقة في حدوث خطأ في وقت التشغيل
- النهاية - يوقف معالجة البرنامج النصي ، ويعيد النتيجة الحالية
- تدفق - يرسل الإخراج المخزن مؤقتًا على الفور. إذا لم يتم تعيين Response.Buffer إلى true ، فستتسبب هذه الطريقة في حدوث خطأ في وقت التشغيل
- إعادة توجيه ( عنوان url ) - يعيد توجيه المستخدم إلى عنوان url آخر
- اكتب ( data_to_write ) - يكتب نصًا للمستخدم
طلب كائن
عندما يطلب المستعرض صفحة من الخادم ، يطلق عليه طلب. يتم استخدام كائن الطلب للحصول على معلومات من المستخدم.
مجموعة
- ClientCertificate - تحمل قيم الحقول المخزنة في شهادة العميل
- ملفات تعريف الارتباط ( الاسم ) - يحتفظ بقيم ملفات تعريف الارتباط
- النموذج ( element_name ) - يحمل قيم النموذج (الإدخال). يجب أن يستخدم النموذج طريقة النشر
- QueryString ( variable_name ) - يحمل قيمًا متغيرة في سلسلة الاستعلام
- ServerVariables ( server_variable ) - يحمل قيمًا متغيرة للخادم
ملكية
- TotalBytes - يحتفظ بإجمالي عدد وحدات البايت التي يرسلها العميل في نص الطلب
طريقة
- BinaryRead - يجلب البيانات التي يتم إرسالها إلى الخادم من العميل كجزء من طلب النشر
كائن الخادم
يتم استخدام كائن الخادم للوصول إلى الخصائص والأساليب الموجودة على الخادم.
ملكية
- ScriptTimeout - يضبط المدة التي يمكن أن يعمل بها البرنامج النصي قبل إنهائه
طريقة
- CreateObject ( type_of_object ) - إنشاء مثيل لكائن
- تنفيذ ( مسار ) - تنفيذ ملف ASP من داخل ملف ASP آخر. بعد تنفيذ ملف ASP يسمى ، يتم إرجاع عنصر التحكم إلى ملف ASP الأصلي
- GetLastError () - إرجاع كائن ASPError يصف الخطأ الذي حدث
- HTMLEncode ( سلسلة ) - لتطبيق ترميز HTML على سلسلة
- MapPath ( مسار ) - تعيين مسار نسبي أو افتراضي إلى مسار فعلي
- نقل ( مسار ) - يرسل جميع معلومات الحالة إلى ملف ASP آخر للمعالجة. بعد النقل ، لا يتم إرجاع التحكم الإجرائي إلى ملف ASP الأصلي
- URLEncode ( سلسلة ) - لتطبيق قواعد تشفير URL على سلسلة
المصدر: https://www.w3schools.com/asp/asp_quickref.asp