دستورالعمل های ASP.NET دستورالعمل هایی برای تعیین تنظیمات اختیاری مانند ثبت کنترل سفارشی و زبان صفحه هستند. این تنظیمات نحوه پردازش صفحات فرم های وب (aspx.) یا کنترل های کاربر (ascx.) توسط چارچوب Net را توضیح می دهند.
نحو برای اعلان یک دایرکتیو به صورت زیر است:
<%@ directive_name attribute=value [attribute=value] %>
در این بخش فقط به معرفی دستورالعمل های ASP.NET می پردازیم و از اکثر این دستورالعمل ها در طول آموزش استفاده خواهیم کرد.
دستورالعمل کاربردی
دستورالعمل Application ویژگی های خاص برنامه را تعریف می کند. در بالای فایل global.aspx ارائه شده است.
سینتکس اصلی Application Directive به شرح زیر است:
<%@ Application Language="C#" %>
ویژگی های دستورالعمل برنامه عبارتند از:
توضیحات ویژگی ها
ارث می برد نام کلاسی که از آن ارث می برد.
توضیحات توضیحات متنی برنامه. تجزیه کننده ها و کامپایلرها این را نادیده می گیرند.
زبان زبانی که در بلوک های کد استفاده می شود.
دستورالعمل مجمع
دستورالعمل Assembly یک اسمبلی را به صفحه یا برنامه در زمان تجزیه پیوند می دهد. این می تواند در فایل global.asax برای پیوند در سطح برنامه، در فایل صفحه، فایل کنترل کاربر برای پیوند دادن به صفحه یا کنترل کاربر ظاهر شود.
دستور اصلی اسمبلی عبارت است از:
<%@ Assembly Name ="myassembly" %>
ویژگی های دستورالعمل مجمع عبارتند از:
توضیحات ویژگی ها
نام نام مجموعه ای که باید پیوند داده شود.
Src مسیر فایل منبعی که باید به صورت پویا پیوند داده و کامپایل شود.
دستورالعمل کنترل
دستورالعمل کنترل با کنترل های کاربر استفاده می شود و در فایل های کنترل کاربر (ascx.) ظاهر می شود.
دستور اصلی دستورات Control به صورت زیر است:
<%@ Control Language="C#" EnableViewState="false" %>
ویژگی های دستورالعمل کنترل عبارتند از:
توضیحات ویژگی ها
AutoEventWireup مقدار بولی که ارتباط خودکار رویدادها را به کنترل کننده ها فعال یا غیرفعال می کند.
ClassName نام فایل برای کنترل.
اشکال زدایی مقدار بولی که کامپایل با نمادهای اشکال زدایی را فعال یا غیرفعال می کند.
توضیحات توضیحات متن صفحه کنترل که توسط کامپایلر نادیده گرفته شده است.
EnableViewState مقدار بولی که نشان می دهد وضعیت view در درخواست های صفحه حفظ می شود یا خیر.
Explicit برای زبان VB، به کامپایلر می گوید که از حالت صریح گزینه استفاده کند.
ارث می برد کلاسی که صفحه کنترل از آن ارث می برد.
زبان زبان کد و اسکریپت.
Src نام فایل برای کلاس کد پشت.
Strict برای زبان VB، به کامپایلر می‌گوید که از حالت سخت استفاده کند.
بخشنامه اجرا می کند
دستورالعمل پیاده سازی نشان می دهد که صفحه وب، صفحه اصلی یا صفحه کنترل کاربر باید رابط فریمورک .Net مشخص شده را پیاده سازی کند.
نحو اصلی برای دستورالعمل پیاده سازی به شرح زیر است:
<%@ Implements Interface="interface_name" %>
دستورالعمل واردات
دستورالعمل Import یک فضای نام را به یک صفحه وب، صفحه کنترل کاربر برنامه وارد می کند. اگر دایرکتیو Import در فایل global.asax مشخص شده باشد، در کل برنامه اعمال می شود. اگر در صفحه ای از صفحه کنترل کاربر باشد، در آن صفحه یا کنترل اعمال می شود.
نحو اصلی برای دستور واردات عبارت است از:
<%@ namespace="System.Drawing" %>
دستورالعمل اصلی
دستورالعمل Master یک فایل صفحه را به عنوان صفحه اصلی مشخص می کند.
نحو اصلی دستورالعمل نمونه MasterPage به شرح زیر است:
<%@ MasterType attribute="value"[attribute="value" ...] %>
دستورالعمل OutputCache
دستور OutputCache سیاست های کش خروجی یک صفحه وب یا کنترل کاربر را کنترل می کند.
نحو اصلی دستور OutputCache عبارت است از:
<%@ OutputCache Duration="15" VaryByParam="None" %>
دستورالعمل صفحه
دستورالعمل Page ویژگی های خاص فایل صفحه را برای تجزیه کننده صفحه و کامپایلر تعریف می کند.
دستور اصلی Page Directive به صورت زیر است:
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>
ویژگی های دستورالعمل Page عبارتند از:
توضیحات ویژگی ها
AutoEventWireup مقدار بولی که رویدادهای صفحه را فعال یا غیرفعال می کند که به طور خودکار به متدها متصل می شوند. به عنوان مثال، Page_Load.
بافر مقدار بولی که بافر پاسخ HTTP را فعال یا غیرفعال می کند.
ClassName نام کلاس برای صفحه.
ClientTarget مرورگری که سرور برای آن کنترل می کند باید محتوا را ارائه دهد.
CodeFile نام کد پشت فایل.
اشکال زدایی مقدار بولی که کامپایل با نمادهای اشکال زدایی را فعال یا غیرفعال می کند.
توضیحات توضیحات متنی صفحه که توسط تجزیه کننده نادیده گرفته شده است.
EnableSessionState فعال، غیرفعال یا حالت جلسه را فقط خواندنی می کند.
EnableViewState مقدار بولی که حالت view را در درخواست‌های صفحه فعال یا غیرفعال می‌کند.
آدرس صفحه خطا برای هدایت مجدد در صورت بروز استثنای صفحه کنترل نشده.
ارث می برد نام کد پشت یا کلاس دیگر.
زبان زبان برنامه نویسی برای کد.
Src نام فایل کد پشت کلاس.
Trace ردیابی را فعال یا غیرفعال می کند.
TraceMode نشان می دهد که چگونه پیام های ردیابی نمایش داده می شوند و بر اساس زمان یا دسته بندی مرتب می شوند.
تراکنش نشان می دهد که آیا تراکنش ها پشتیبانی می شوند یا خیر.
ValidateRequest مقدار بولی که نشان می دهد که آیا تمام داده های ورودی در برابر لیستی از مقادیر کدگذاری شده اعتبارسنجی شده اند یا خیر.
دستورالعمل PreviousPageType
دستورالعمل PreviousPageType یک کلاس را به یک صفحه اختصاص می دهد، به طوری که صفحه به شدت تایپ می شود.
نحو اصلی برای نمونه دستور PreviousPagetype به شرح زیر است:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>
دستورالعمل مرجع
دستورالعمل مرجع نشان می دهد که صفحه یا کنترل کاربر دیگری باید کامپایل شده و به صفحه فعلی پیوند داده شود.
نحو اصلی دستورالعمل مرجع به شرح زیر است:
<%@ Reference Page ="somepage.aspx" %>
دستورالعمل ثبت نام
مشتق Register برای ثبت کنترل های سرور سفارشی و کنترل های کاربر استفاده می شود.
نحو اصلی دستور ثبت به شرح زیر است:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>
