التوجيهات والمسارات او التفضيلات في اي اس بي دوت نت ASP.NET Directives#

التوجيهات او التفضيلات في اي اس بي دوت نت ASP.NET Directives#

توجيهات ASP.NET هي إرشادات لتحديد الإعدادات الاختيارية ، مثل تسجيل عنصر تحكم مخصص ولغة الصفحة.  توضح هذه الإعدادات كيفية معالجة صفحات نماذج الويب (.aspx) أو عناصر تحكم المستخدم (.ascx) بواسطة إطار .Net.

 بناء الجملة للتصريح التوجيه هو:

<%@  directive_name attribute=value  [attribute=value]  %>

في هذا القسم ، سنقدم فقط توجيهات ASP.NET وسنستخدم معظم هذه التوجيهات في جميع البرامج التعليمية.

الاعدادات التطبيقات The Application Directive

يعرّف توجيه التطبيق السمات الخاصة بالتطبيق.  يتم توفيره في الجزء العلوي من ملف global.aspx.

 بناء الجملة الأساسي لتوجيه التطبيق هو:

<%@ Application Language="C#" %>

سمات توجيه التطبيق هي:

الخاصية	الوصف
Inherits	اسم الفئة التي ترث منها.
Description	وصف النص للتطبيق.  المحللون والمجمعون تجاهل هذا.
Language	اللغة المستخدمة في كتل التعليمات البرمجية.

مسار التجميع  The Assembly Directive

يربط توجيه التجميع التجميع بالصفحة أو التطبيق في وقت التحليل.  قد يظهر هذا إما في ملف global.asax للربط على نطاق التطبيق ، في ملف الصفحة ، ملف تحكم المستخدم للربط بصفحة أو عنصر تحكم مستخدم.

بناء الجملة الأساسي للتوجيه التجميع هو:

<%@ Assembly Name ="myassembly" %>

سمات توجيه التجميع هي:

الخاصية	الوصف
Name	اسم التجميع المراد ربطه.
Src	المسار إلى الملف المصدر الذي سيتم ربطه وتجميعه ديناميكيًا.

مسار التحكم The Control Directive

يتم استخدام توجيه التحكم مع عناصر تحكم المستخدم ويظهر في ملفات التحكم (.ascx) المستخدم.

 البنية الأساسية لتوجيه التحكم هي:

<%@ Control Language="C#"  EnableViewState="false" %>

صفات توجيه التحكم هي:

الصفة	الوصف
AutoEventWireup	القيمة المنطقية التي تتيح أو تعطل الارتباط التلقائي للأحداث للمعالجات.
ClassName	اسم الملف لعنصر التحكم.
Debug	القيمة المنطقية التي تتيح أو تعطيل التحويل البرمجي برموز التصحيح.
Description	وصف النص لصفحة التحكم ، يتم تجاهله من قبل المترجم.
EnableViewState	قيمة منطقية تشير إلى ما إذا كان يتم الاحتفاظ بحالة العرض عبر طلبات الصفحة.
Explicit	بالنسبة للغة VB ، يخبر المترجم استخدام الوضع الصريح للخيار.
Inherits	الفئة التي ترث منها صفحة التحكم.
Language	لغة الكود والنص.
Src	اسم ملف فئة التعليمات البرمجية الخلفية.
Strict	بالنسبة للغة VB ، يخبرك المترجم باستخدام الوضع الصارم للخيار.

مسار التنفيذ The Implements Directive

يشير توجيه التنفيذ إلى أن صفحة الويب أو الصفحة الرئيسية أو صفحة التحكم في المستخدم يجب أن تنفذ واجهة إطار عمل .Net المحددة.

 بناء الجملة الأساسي لتنفيذ التوجيه هو:

<%@ Implements  Interface="interface_name" %>

مسار الاستيراد The Import Directive

يستورد توجيه الاستيراد مساحة اسم في صفحة ويب ، صفحة تحكم المستخدم في التطبيق.  إذا تم تحديد توجيه الاستيراد في ملف global.asax ، فسيتم تطبيقه على التطبيق بأكمله.  إذا كانت موجودة في صفحة تحكم المستخدم ، فسيتم تطبيقها على تلك الصفحة أو عنصر التحكم.

 بناء الجملة الأساسي لتوجيه الاستيراد هو:

<%@ namespace="System.Drawing" %>

المسار الرئيسى The Master Directive

يحدد التوجيه الرئيسي ملف الصفحة على أنه صفحة mater.

 بناء الجملة الأساسي لتوجيه نموذج MasterPage هو:

<%@ MasterPage Language="C#"  AutoEventWireup="true"  CodeFile="SiteMater.master.cs" Inherits="SiteMaster"  %>

مسار للنوع الرئيسى The MasterType Directive

يقوم توجيه MasterType بتعيين اسم فئة للخاصية الرئيسية للصفحة ، لجعله مكتوبًا بقوة.

 بناء الجملة الأساسي لتوجيه MasterType هو:

<%@ MasterType attribute="value"[attribute="value" ...]  %>

مسار الذاكرة المؤقت The OutputCache Directive

يتحكم توجيه OutputCache في سياسات التخزين المؤقت للإخراج لصفحة ويب أو عنصر تحكم مستخدم.

 بناء الجملة الأساسي لتوجيه OutputCache هو:

<%@ OutputCache Duration="15" VaryByParam="None"  %>

مسار الصفحة The Page Directive

يعرّف توجيه الصفحة السمات الخاصة بملف الصفحة لمحلل الصفحة والمترجم.

 بناء الجملة الأساسي لتوجيه الصفحة هو:

<%@ Page Language="C#"  AutoEventWireup="true" CodeFile="Default.aspx.cs"  Inherits="_Default"  Trace="true" %>

خصائص مسار الصفحة  The attributes of the Page directive are:

الصفة	الوصف
AutoEventWireup	قيمة منطقية تمكن أو تعطل أحداث الصفحة المرتبطة تلقائيًا بالطرق ؛  على سبيل المثال ، Page_Load.
Buffer	القيمة المنطقية التي تعمل على تمكين أو تعطيل التخزين المؤقت استجابة HTTP.
ClassName	اسم الفئة  للصفحة.
ClientTarget	يجب أن يعرض المستعرض الذي يتحكم فيه الخادم المحتوى.
CodeFile	اسم الكود خلف الملف.
Debug	القيمة المنطقية التي تتيح أو تعطيل التحويل البرمجي برموز التصحيح.
Description	الوصف النصي للصفحة ، يتجاهله المحلل اللغوي.
EnableSessionState	إنه يتيح أو تعطيل أو يجعل حالة الجلسة للقراءة فقط.
EnableViewState	القيمة المنطقية التي تمكن أو تعطل حالة العرض عبر طلبات الصفحة.
ErrorPage	عنوان URL لإعادة التوجيه في حالة حدوث استثناء صفحة غير معالج.
Inherits	اسم الكود خلف أو فئة أخرى.
Language	لغة البرمجة للكود.
Src	اسم ملف الكود خلف الفصل.
Trace	أنها تمكن أو تعطيل التتبع.
TraceMode	يشير إلى كيفية عرض رسائل التتبع وفرزها حسب الوقت أو الفئة.
Transaction	يشير إلى ما إذا كانت المعاملات مدعومة.
ValidateRequest	قيمة منطقية تشير إلى ما إذا كان يتم التحقق من صحة جميع بيانات الإدخال مقابل قائمة من القيم الثابتة.

مسار نوع الصفحة السابقة The PreviousPageType Directive

يعين التوجيه PreviousPageType فئة إلى صفحة ، بحيث تتم طباعة الصفحة بشدة.

 بناء الجملة الأساسي لتوجيه PreviousPagetype عينة هو:

<%@ PreviousPageType attribute="value"[attribute="value" ...]   %>

مسار الصفحة المرجعية The Reference Directive

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

 البنية الأساسية للتوجيه المرجعي هي:

<%@ Reference Page ="somepage.aspx" %>

مسار التسجيل The Register Directive

يتم استخدام مشتق التسجيل لتسجيل عناصر تحكم الملقم المخصص وعناصر تحكم المستخدم.

 البنية الأساسية لتوجيه السجل هي:

<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>