ASP.NET - دستورالعمل ها

دستورالعمل های 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" %>