استفاده از فایل‌های مرجع ASP

دستور #include برای ایجاد توابع، سربرگ‌ها، پایش‌ها و یا عناصر دیگر مورد استفاده در صفحات متعدد است.

دستور #include

با استفاده از دستور #include، می‌توانیم یک فایل ASP دیگر را قبل از اجرای فایل ASP در سرور به این فایل اضافه کنیم. دستور #include برای ایجاد توابع، سربرگ‌ها، پایش‌ها و یا عناصر دیگر مورد استفاده در صفحات متعدد است.

چگونه از دستور #include استفاده کنیم

این یک فایل به نام "mypage.asp" است:

<html> 
<body> 
<h2>عبارات هوشمندانه:</h2>
<p><!--#include file="wisdom.inc"--></p> 
<h2>زمان حال:</h2>
<p><!--#include file="time.inc"--></p>
</body> 
</html>

این فایل "wisdom.inc" است:

"هرگز نباید چیزی را فراتر از آنچه که لازم است، افزایش داد.
تعداد اشیایی که برای توضیح هر چیزی نیاز است.

این فایل "time.inc" است:

<%
Response.Write(Time)
%>

کد منبعی که در مرورگر مشاهده می‌کنید باید مشابه این باشد:

<html>
<body>
<h2>عبارات هوشمندانه:</h2>
هرگز نباید چیزی را فراتر از آنچه که لازم است، افزایش داد.
تعداد موجودیاتی که برای توضیح هر چیزی نیاز است.</p>
<h2>زمان حال:</h2>
<p>11:33:42 AM</p>
</body>
</html>

ساختار مراجعه به فایل‌ها:

برای مراجعه به فایل‌ها در ASP، دستور #include را در میان برچسب‌های نظرات قرار دهید:

<!--#include virtual="somefilename"-->

یا:

<!--#include file ="somefilename"-->

کلمه‌کلیدی Virtual

کلمه‌کلیدی virtual مسیر را از پوشه مجازی آغاز می‌کند.

اگر فایل "header.inc" در پوشه مجازی /html قرار دارد، خط زیر محتوای فایل "header.inc" را به اسکریپت اضافه می‌کند:

<!-- #include virtual ="/html/header.inc" -->

کلمه‌کلیدی File

کلمه‌کلیدی File یک مسیر نسبی را نشان می‌دهد. مسیر نسبی از پوشه‌ای که فایل مراجعه شده در آن قرار دارد، آغاز می‌شود.

فرض کنید فایل در پوشه‌ای به نام headers در پوشه html قرار دارد، دستور زیر می‌تواند محتوای فایل "header.inc" را مراجعه کند:

<!-- #include file ="headers\header.inc" -->

توجه داشته باشید:مسیر فایل‌های مراجعه شده به نسبت فایل مراجعه شده محاسبه می‌شود. اگر فایل شامل دستور #include در پوشه html قرار نگیرد، این دستور کار نکند.

شما همچنین می‌توانید از کلمه‌کلیدی file و ساختار (..\) برای مراجعه به فایل‌های درون پوشه‌های بالاتر استفاده کنید.

راهنمایی‌ها و توضیحات:

در بخش‌های قبل، ما از ".inc" به عنوان پسوند فایل‌های مراجعه شده استفاده کرده‌ایم. توجه داشته باشید: اگر کاربر سعی کند مستقیماً فایل‌های INC را مشاهده کند، محتوای آن‌ها نمایش داده خواهد شد. اگر محتوای فایل‌های مراجعه شده شامل اطلاعات محرمانه باشد، بهتر است از "asp" به عنوان پسوند استفاده کنید. کد منبع فایل‌های ASP پس از ترجمه غیرقابل مشاهده خواهد بود. فایل‌های مراجعه شده نیز می‌توانند فایل‌های دیگر را مراجعه کنند و یک فایل ASP می‌تواند چندین مرتبه به یک فایل مراجعه کند.

ملاحظات مهم:در حالی که اسکریپت در حال اجرا است، فایل‌های مراجعه شده به آن پردازش و به اسکریپت اضافه می‌شوند.

این کد قابل اجرا نیست، زیرا ASP قبل از اختصاص داده شدن به متغیرها، دستور #include را اجرا می‌کند:

<%
fname="header.inc"
%>
<!--#include file="<%=fname%>"-->

نمیتوانید به عنوان مرزهای اسکریپت، مراجعه به فایل‌ها را درج کنید:

<%
For i = 1 To n
  <!--#include file="count.inc"-->
Next
%>

اما این اسکریپت می‌تواند کار کند:

<% For i = 1 to n %>
<!--#include file="count.inc" -->
<% Next %>