توجيهات ASP.NET هي تعليمات لتحديد الإعدادات الاختيارية، مثل تسجيل عنصر تحكم مخصص ولغة الصفحة. تصف هذه الإعدادات كيفية تعامل NET Framework مع صفحات الويب ذات النموذج أحادي الصفحة (.aspx) أو صفحات الويب الخاصة بتحكم المستخدم (.ascx).
بناء الجملة الأساسي لإصدار الأوامر:
<%@ directive_name attribute=value [attribute=value] %>في هذا القسم، سنقدم توجيهات ASP.NET، والتي سيتم استخدام معظمها خلال البرنامج التعليمي.
تحدد توجيهات التطبيق الخصائص الخاصة بالتطبيق. يتم توفيره في الجزء العلوي من الملف global.aspx.
بناء الجملة الأساسي لتعليمات التطبيق:
<%@ Application Language="C#" %>خصائص توجيه التطبيق:
| ملكية | يصف |
|---|---|
| يرث | ورثت من اسم الطبقة. |
| وصف | وصف نصي للتطبيق. يتجاهل المحلل اللغوي والمترجم هذا. |
| لغة | اللغة المستخدمة في مجموعة التعليمات البرمجية. |
تربط توجيهات التجميع المكونات بصفحة ويب أو تطبيق أثناء التحليل. قد يحدث هذا عبر رابط نوع التطبيق في ملف Global.asax، أو في ملف صفحة، أو في عنصر تحكم مستخدم يرتبط بصفحة ويب أخرى، أو في عنصر تحكم مستخدم.
بناء الجملة الأساسي للتحكم في المجموعة هو:
<%@ Assembly Name ="myassembly" %>خصائص التحكم في المجموعة هي:
| ملكية | يصف |
|---|---|
| اسم | اسم مكون المجموعة المرتبطة. |
| سرك | المسار الذي يتم من خلاله ربط الملفات المصدر وتحريرها ديناميكيًا. |
يتم استخدام تعليمات التحكم مع عناصر تحكم المستخدم وتظهر في ملفات تحكم المستخدم (.ascx).
الصيغة الأساسية لتعليمات التحكم هي:
<%@ Control Language="C#" EnableViewState="false" %>خصائص تعليمات التحكم هي:
| ملكية | يصف |
|---|---|
| AutoEventWireup | قيمة منطقية تسمح أو تعطل الارتباط التلقائي لمعالجات الأحداث. |
| اسم الفئة | اسم ملف عنصر التحكم. |
| تصحيح | قيمة منطقية تسمح أو تعطل تحرير رموز التصحيح. |
| وصف | الوصف النصي لصفحة التحكم، تم تجاهله من قبل المترجم. |
| EnableViewState | طلب الصفحة هو قيمة منطقية لتحديد ما إذا كان سيتم الحفاظ على حالة العرض أم لا. |
| صريح | في لغة VB، يخبر المحرر باستخدام وضع عرض الخيارات. |
| يرث | التحكم في الفئة التي ورثتها الصفحة. |
| لغة | لغات الترميز والبرمجة النصية. |
| سرك | اسم الملف الخاص بالفئة code-behind. |
| حازم | في لغة VB، يخبر المحرر باستخدام خيار الوضع القياسي. |
تشير توجيهات الأداة إلى أن صفحة الويب أو الصفحة الرئيسية أو صفحة تحكم المستخدم يجب أن تقوم بتنفيذ واجهة .Net Framework محددة.
بناء الجملة الأساسي لتعليمات الأداة هو:
<%@ Implements Interface="interface_name" %>يقوم توجيه الاستيراد باستيراد مساحة اسم إلى صفحة تطبيق يتحكم فيه المستخدم. إذا تم تحديد توجيه الاستيراد في ملف global.asax، فسيتم تطبيقه على التطبيق بأكمله. وإذا كان موجودًا في صفحة ويب ضمن صفحة يتحكم فيها المستخدم، فسيتم تطبيقه على صفحة الويب أو عنصر التحكم هذا.
بناء الجملة الأساسي لتوجيه الاستيراد هو:
<%@ namespace="System.Drawing" %>يحدد التوجيه الرئيسي ملف صفحة باعتباره الصفحة الرئيسية.
بناء الجملة الأساسي لنموذج توجيه الصفحة الرئيسية هو:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>يقوم توجيه MasterType بتعيين اسم فئة للسمة الرئيسية للصفحة، مما يعزز نوعها.
بناء الجملة الأساسي للتوجيه الرئيسي هو:
<%@ MasterType attribute="value"[attribute="value" ...] %>يتحكم توجيه التخزين المؤقت للمخرجات في سياسة التخزين المؤقت للمخرجات لصفحة الويب أو عنصر تحكم المستخدم.
بناء الجملة الأساسي لتعليمات التخزين المؤقت للمخرجات:
<%@ OutputCache Duration="15" VaryByParam="None" %>تحدد توجيهات الصفحة سمات ملف الصفحة لموزعي ومترجمي الصفحات المحددين.
بناء الجملة الأساسي لتوجيه الصفحة هو:
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>خصائص توجيه الصفحة هي:
| ملكية | يصف |
|---|---|
| AutoEventWireup | قيمة منطقية تسمح أو تعطل ربط أحداث الصفحة تلقائيًا بالطرق، على سبيل المثال، Page_Load. |
| المخزن المؤقت | قيمة منطقية تسمح أو تعطل التخزين المؤقت لاستجابة HTTP. |
| اسم الفئة | اسم فئة الصفحة. |
| ClientTarget | يجب أن يعرض عنصر تحكم الخادم المحتوى إلى المتصفح |
| ملف كودي | اسم الملف الكودي الخلفي. |
| تصحيح | قيمة منطقية تسمح أو تعطل التجميع باستخدام رموز التصحيح. |
| وصف | وصف الملف الخاص بالصفحة، تم تجاهله بواسطة المحلل اللغوي. |
| تمكينSessionState | تمكين أو تعطيل حالة جلسة الصفحة للقراءة فقط. |
| EnableViewState | قيمة منطقية تسمح أو لا تسمح بطلبات عبر الصفحات لحالة العرض. |
| صفحة الخطأ | إعادة توجيه العنوان في حالة استثناء الصفحة غير المعالجة. |
| يرث | اسم الكود الخلفي أو فئة أخرى. |
| لغة | لغة برمجة الكود. |
| سرك | اسم الملف الخاص بالفئة code-behind. |
| يتعقب | تمكين أو تعطيل التتبع. |
| وضع التتبع | يشير إلى كيفية عرض معلومات التتبع وفرزها حسب الوقت أو الفئة. |
| عملية | يشير إلى ما إذا كانت المعاملة مدعومة. |
| التحقق من صحة الطلب | قيمة منطقية تشير إلى ما إذا كان قد تم التحقق من كافة بيانات الإدخال بشكل صحيح كقائمة مضمنة. |
يقوم توجيه الصفحة السابق بتعيين فئة للصفحة، مما يؤدي إلى تحسين نوع الصفحة هذا.
بناء الجملة الأساسي لعينة من توجيه الصفحة السابقة:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>يشير التوجيه المرجعي إلى أنه يجب تجميع صفحة أخرى أو عنصر تحكم مستخدم وربطه بالصفحة الحالية.
بناء الجملة الأساسي للتوجيه المرجعي هو:
<%@ Reference Page ="somepage.aspx" %>يتم استخدام توجيه التسجيل لتسجيل عناصر تحكم الخادم المخصصة وعناصر تحكم المستخدم.
بناء الجملة الأساسي لتوجيه التسجيل هو:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>