คำสั่ง ASP.NET เป็นคำแนะนำสำหรับการระบุการตั้งค่าเพิ่มเติม เช่น การลงทะเบียนตัวควบคุมแบบกำหนดเองและภาษาของเพจ การตั้งค่าเหล่านี้อธิบายวิธีที่ NET Framework จัดการเว็บเพจในรูปแบบหน้าเดียว (.aspx) หรือการควบคุมผู้ใช้ (.ascx)
ไวยากรณ์พื้นฐานสำหรับการออกคำสั่ง:
<%@ directive_name attribute=value [attribute=value] %>ในส่วนนี้ เราจะแนะนำคำสั่ง ASP.NET ซึ่งส่วนใหญ่จะใช้ตลอดบทช่วยสอน
คำสั่งของแอปพลิเคชันกำหนดคุณสมบัติเฉพาะของแอปพลิเคชัน มีระบุไว้ที่ด้านบนของไฟล์ global.aspx
ไวยากรณ์พื้นฐานของคำแนะนำการใช้งาน:
<%@ Application Language="C#" %>คุณสมบัติของคำสั่งแอปพลิเคชัน:
| คุณสมบัติ | อธิบาย |
|---|---|
| สืบทอด | สืบทอดมาจากชื่อชั้น |
| คำอธิบาย | คำอธิบายข้อความของแอปพลิเคชัน parser และคอมไพเลอร์ละเว้นสิ่งนี้ |
| ภาษา | ภาษาที่ใช้ในกลุ่มรหัส |
คำสั่งการรวบรวมเชื่อมโยงส่วนประกอบไปยังเว็บเพจหรือแอปพลิเคชันในระหว่างการวิเคราะห์ สิ่งนี้อาจเกิดขึ้นตลอดลิงก์ประเภทแอปพลิเคชันในไฟล์ Global.asax ในไฟล์เพจ ในการควบคุมผู้ใช้ที่เชื่อมโยงไปยังเว็บเพจอื่น หรือในการควบคุมผู้ใช้
ไวยากรณ์พื้นฐานของการควบคุมคอลเลกชันคือ:
<%@ Assembly Name ="myassembly" %>คุณสมบัติของการควบคุมการรวบรวมคือ:
| คุณสมบัติ | อธิบาย |
|---|---|
| ชื่อ | ชื่อของส่วนประกอบคอลเลกชันที่เชื่อมโยง |
| รศ | พาธที่ไฟล์ต้นฉบับลิงก์และแก้ไขแบบไดนามิก |
คำแนะนำการควบคุมจะใช้กับการควบคุมผู้ใช้และปรากฏในไฟล์การควบคุมผู้ใช้ (.ascx)
ไวยากรณ์พื้นฐานของคำสั่งควบคุมคือ:
<%@ Control Language="C#" EnableViewState="false" %>คุณสมบัติของคำสั่งควบคุมคือ:
| คุณสมบัติ | อธิบาย |
|---|---|
| AutoEventWireup | ค่าบูลีนที่อนุญาตหรือปิดใช้งานการเชื่อมโยงตัวจัดการเหตุการณ์โดยอัตโนมัติ |
| ชื่อคลาส | ชื่อไฟล์ของตัวควบคุม |
| ดีบัก | ค่าบูลีนที่อนุญาตหรือปิดใช้งานการแก้ไขสัญลักษณ์การดีบัก |
| คำอธิบาย | คำอธิบายข้อความของหน้าควบคุม คอมไพเลอร์ละเว้น |
| เปิดใช้งานViewState | คำขอเพจเป็นค่าบูลีนว่าจะคงสถานะมุมมองไว้หรือไม่ |
| ชัดเจน | ในภาษา VB บอกให้เอดิเตอร์ใช้โหมดการแสดงตัวเลือก |
| สืบทอด | ควบคุมคลาสที่สืบทอดมาจากเพจ |
| ภาษา | การเขียนโค้ดและภาษาสคริปต์ |
| รศ | ชื่อไฟล์ของคลาสที่อยู่เบื้องหลังโค้ด |
| เข้มงวด | ในภาษา VB บอกให้บรรณาธิการใช้ตัวเลือก Standard Mode |
คำสั่งเครื่องมือระบุว่าเว็บเพจ มาสเตอร์เพจ หรือเพจควบคุมผู้ใช้ต้องใช้อินเทอร์เฟซ .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 |
| ชื่อคลาส | ชื่อหมวดหมู่ของเพจ |
| เป้าหมายลูกค้า | การควบคุมเซิร์ฟเวอร์ควรแสดงเนื้อหาไปยังเบราว์เซอร์ |
| รหัสไฟล์ | ชื่อของไฟล์ที่อยู่เบื้องหลังโค้ด |
| ดีบัก | ค่าบูลีนที่อนุญาตหรือปิดใช้งานการคอมไพล์ด้วยสัญลักษณ์การแก้ไขข้อบกพร่อง |
| คำอธิบาย | คำอธิบายไฟล์ของเพจ ซึ่งถูกละเว้นโดย parser |
| EnableSessionState | เปิดใช้งานหรือปิดใช้งานสถานะเซสชันของเพจเป็นแบบอ่านอย่างเดียว |
| เปิดใช้งานViewState | ค่าบูลีนที่อนุญาตหรือไม่อนุญาตคำขอข้ามเพจสำหรับสถานะมุมมอง |
| ข้อผิดพลาดหน้า | เปลี่ยนเส้นทางที่อยู่ในกรณีที่มีข้อยกเว้นหน้าที่ไม่สามารถจัดการได้ |
| สืบทอด | ชื่อของโค้ดหลังหรือคลาสอื่น |
| ภาษา | ภาษาการเขียนโปรแกรมโค้ด |
| รศ | ชื่อไฟล์ของคลาสที่อยู่เบื้องหลังโค้ด |
| ติดตาม | เปิดหรือปิดการติดตาม |
| ติดตามโหมด | ระบุวิธีการแสดงข้อมูลการติดตามและจัดเรียงตามเวลาหรือหมวดหมู่ |
| ธุรกรรม | ระบุว่าธุรกรรมได้รับการสนับสนุนหรือไม่ |
| ตรวจสอบคำขอ | ค่าบูลีนที่ระบุว่าข้อมูลอินพุตทั้งหมดได้รับการตรวจสอบความถูกต้องว่าเป็นรายการฮาร์ดโค้ดหรือไม่ |
คำสั่งหน้าก่อนหน้านี้กำหนดหมวดหมู่ให้กับเพจ ทำให้ประเภทเพจนั้นได้รับการปรับปรุง
ไวยากรณ์พื้นฐานสำหรับตัวอย่างของคำสั่งหน้าก่อนหน้า:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>คำสั่งอ้างอิงระบุว่าควรรวบรวมเพจหรือการควบคุมผู้ใช้อื่นและเชื่อมโยงกับเพจปัจจุบัน
ไวยากรณ์พื้นฐานของคำสั่งอ้างอิงคือ:
<%@ Reference Page ="somepage.aspx" %>คำสั่งการลงทะเบียนใช้เพื่อลงทะเบียนการควบคุมเซิร์ฟเวอร์แบบกำหนดเองและการควบคุมผู้ใช้
ไวยากรณ์พื้นฐานของคำสั่งการลงทะเบียนคือ:
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>