مفهوم دایرکتیوها در ASP.NET و بررسی به همراه چند مثال

دایرکتیوهای ASP.NET دستورالعمل هایی برای تعیین تنظیمات اختیاری مانند ثبت یک کنترل سفارشی و زبان صفحه می باشند. این تنظیمات چگونگی پردازش فرم های وب (.aspx) یا صفحات کنترل های کاربر (.ascx) را از طریق فریم ورک .Net تشریح می کنند.

قاعده نوشتاری (syntax) مربوط به اعلام دایرکتیوها به صورت زیر است:

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

در این بخش ، ما فقط دایرکتیوهای ASP.NET را معرفی خواهیم کرد و در آموزش های بعدی به طور گسترده  از این دایرکتیوها استفاده خواهیم نمود

دایرکتیو Application.

دایرکتیو Application ، صفت های ویژه برنامه کاربردی را تعریف می کند. این دایرکتیو در بالای فایل global.aspx قرار می گیرد.

قاعده نوشتاری اصلی از دایرکتیو Application به صورت زیر است:

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

صفت های دایرکتیو Application به شرح جدول ذیل هستند:

دایرکتیو Assembly

دایرکتیو Assembly ، یک اسمبلی را در زمان parse ، به صفحه یا برنامه کاربردی پیوند می دهد. این دایرکتیو می تواند هم در فایل global.asax برای لینک کردن برنامه کاربردی و هم در فایل صفحه ، فایل کنترل کاربر برای لینک کردن به صفحه یا کنترل کاربر نمایان شود.

قاعده نوشتاری از دایرکتیو Assembly به صورت زیر می باشد:

<%@ Assembly Name ="myassembly" %>

جدول زیر صفته های دایرکتیو Assembly را نشان می دهد:

دایرکتیو Control

دایرکتیو Control با کنترل های کاربر مورد استفاده قرار می گیرد و در فایل های کنترل کاربر (.ascx) ظاهر می شود.

قاعده نوشتاری از دایرکتیو Control به صورت زیر می باشد:

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

صفت های دایرکتیو Control به شرح جدول ذیل می باشند:

دایرکتیوهای Implements

دایرکتیو Implement نشان می دهد که صفحه وب ، صفحه master یا صفحه کنترل کاربر باید رابط فریم ورک .Net را که مشخص شده است ، اجرا نمایند.

قاعده نوشتاری اصلی از دایرکتیو Implement به صورت زیر می باشد:

<%@ Implements  Interface="interface_name" %>

دایرکتیو Import

دایرکتیو Import یک namespace را به داخل صفحه وب ، صفحه کنترل کاربر برنامه کاربردی import می کند. اگر دایرکتیو Import در فایل global.asax مشخص شده باشد ، در این صورت این دایرکتیو برای کل برنامه کاربردی اعمال می شود. اگر در یک صفحه از صفحه کنترل کاربر مشخص شده باشد ، در این صورت برای این صفحه یا کنترل اعمال می شود.

قاعده نوشتاری دایرکتیو Import به صورت زیر می باشد:

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

دایرکتیو Master

دایرکتیو Master یک فایل صفحه را به عنوان صفحه master ، مشخص می کند.

قاعده نوشتاری از نمونه دایرکتیو MasterPage به صورت زیر است:

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

دایرکتیو MasterType

دایرکتیو MasterType یک نام کلاس را به خصیصه Master از یک صفحه تخصیص می دهد ، تا آن را از نوع strongly typed قرار دهد.

 قاعده نوشتاری از دایرکتیو MasterType به صورت زیر می باشد:

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

دایرکتیو OutputCache

دایرکتیو OutputCache ، سیاست caching (ذخیره سازی) خروجی از یک صفحه وب با یک صفحه کنترل کاربر را کنترل می کند.

قاعده نوشتاری از دایرکتیو OutputCache به صورت زیر می باشد:

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

دایرکتیو Page

دایرکتیو Page صفت های ویژه فایل صفحه را برای پارسر و کامپایلر صفحه تعریف می کند.

قاعده نوشتاری دایرکتیو صفحه به صورت زیر است:

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

صفت های دایرکتیو Page در جدول ذیل ارائه شده است:

دایرکتیو PreviousPageType

دایرکتیو PreviousPageType یک کلاس را به یک صفحه تخصیص می دهد ، به طوری که صفحه به صورت strongly typed باشد.

قاعده نوشتاری برای یک دایرکتیو نمونه PreviousPageType به صورت زیر می باشد:

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

دایرکتیو Reference

دایرکتیو Reference نشان می دهد که صفحه یا کنترل کاربر دیگری باید به صورت کامپایل شده و لینک شده به صفحه جاری باشد.

قاعده نوشتاری از دایرکتیو Reference به صورت زیر می باشد:

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

دایرکتیو Register

دایرکتیو Register برای ثبت کنترل های سرور سفارشی و کنترل های کاربر مورد استفاده قرار می گیرد.

قاعده نوشتاری از دایرکتیو Register به صورت زیر می باشد:

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