مشاركة عبر

تضمين جانب الخادم بناء جملة توجيهي

  • مقالة

إدراج محتويات الملف المحدد ضمن ملف ASP.NET بما في ذلك الصفحات ويب (.aspx ملفات) المستخدم عنصر تحكم (ملفات .ascx) وملفات عمومي.asax

<!-- #include file|virtual="filename" -->

السمات

  • File
    اسم الملف هو مسار فعلي من الدليل الذي يحتوي على الملف مع #include التوجيه. يمكن أن يكون هذا المسار النسبي.

    ملاحظةملاحظة

    يمكن أن يكون الملف المضمن في نفس الدليل أو في دليل فرعي; لا يمكن أن تكون في الدليل أعلاه الملف مع #include التوجيه.

  • Virtual
    اسم الملف هو مسار ظاهري من الدليل الظاهري في موقع ويب. يمكن أن يكون هذا المسار النسبي.

    ملاحظةملاحظة

    هذا الأسلوب المستحسن نتيجة التغييرات المحتملة في المسار الفعلي إلى ملف.

ملاحظات

القيمة التي تم تعيينها في File أو Virtual السمة يجب أن تتم إحاطتها بعلامات اقتباس (""). تتم معالجة الملف المُضمن قبل تنفيذ أية تعليمات برمجية ديناميكيا. تتضمن استخدام ملفات تحتوي على أي شيء من نص ثابت (مثل رأس صفحة عامة أو عنوان شركة) الشائعة ، تعليمات برمجية من جانب الخادم أو عناصر كتل ترميز HTML التي يرغب المطوّر بإدراجها داخل الصفحات الأخرى.

ملاحظةملاحظة

على الرغم من أنه ما زال بإمكانك استخدام العلامة بهدف إعادة استخدام التعليمات البرمجية (عن طريق وضع عناصر التحكم الشائعة تعليمات برمجية من جانب الخادم أو توصيف HTML داخل ملف إلى تضمينها في الصفحات ويب الأخرى) ، غالباً ما يكون الأسلوب المفضل في ASP.NET إلى استخدام عناصر تحكم مستخدم ويب.توفر عناصر تحكم المستخدم على طراز البرمجة الموجهة وتضمين وظيفة أكبر بكثير من جانب الخادم.للمزيد من التفاصيل ، راجع عناصر تحكم ASP.NET المستخدم.

#include يجب وضع العلامة داخل محددات تعليق HTML أو XML لتجنب ما يتم تفسيره على أنه نص حرفي.

مثال

يوضح مثال التعليمات البرمجية التالي كيفية استخدام من جانب الخادم بتضمين بناء الجملة موجهاً لاستدعاء الملفات التي ستقوم بإنشاء عنوان وتذييل على صفحة الـ ASP.NET. كلاهما يستخدمم كلا المسارات النسبية.

<html>
   <body>
      <!-- #Include virtual="/include/header.inc" -->
        Here is the main body of the .aspx file.
      <!-- #Include virtual="/include/footer.inc" -->
   </body>
</html>

راجع أيضًا:

المبادئ

نظرة عامة حول بناء جملة صفحة ASP.NET على ويب

موارد أخرى

عناصر تحكم ASP.NET المستخدم