تصدير (0) طباعة
توسيع الكل

الصفحات ASP.NET الرئيسية

.NET Framework 4

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

تتضمن هذه النظرة العامة الأقسام التالية:

تتكون الصفحات الرئيسية فعلياً من القطع اثنين "و" الصفحة الرئيسية نفسها "و" صفحة محتوى واحدة أو أكثر.

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

يمكنك أيضاً تداخل الصفحات الرئيسية. للحصول على تفاصيل، راجع الصفحات ASP.NET الرئيسية المتداخلة.

الصفحات الرئيسية

صفحة رئيسية عبارة عن ملف ASP.NET مع .master ملحق (على سبيل المثال، MySite.master) مع تخطيط معرّف مسبقاً التي يمكن أن تتضمن نص ثابت عناصر HTML وعناصر الملقم. يتم التعرف على الصفحة الرئيسية من خلال خاصة @ الرئيسية توجيه استبدال صفحة @ توجيه المستخدم من أجل صفحات .aspx العادية. يبحث التوجيه كما يلي.

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

The @ Master directive can contain most of the same directives that a @ التحكم directive can contain. على سبيل المثال، توجيه الصفحة الرئيسية التالية يتضمن اسم ملف التعليمات البرمجية الخلفية ويقوم بتعيين اسم فئة إلى صفحة رئيسية.

<%@ Master Language="C#" CodeFile="MasterPage.master.cs" Inherits="MasterPage" %>

In addition to the @ Master directive, the master page also contains all of the top-level HTML elements for a page, such as html, head, and form. على سبيل المثال، على صفحة رئيسية يمكنك استخدام جدول HTML لتخطيط img عنصر شعار الشركة أو نص ثابت إشعار حقوق النشر وعناصر التحكم الملقم لإنشاء القياسية التنقل للموقع الخاص بك. يمكنك استخدام أي HTML و أية عناصر ASP.NET كجزء من الصفحة الرئيسية.

العناصر النائبة محتوى قابل للاستبدال

بالإضافة إلى نص ثابت وعناصر التحكم التي تظهر على كافة الصفحات ، الصفحة الرئيسية أيضاً يتضمن واحد أو أكثر من ContentPlaceHolder عناصر التحكم. تحديد عناصر تحكم العنصر النائب هذه المناطق حيث سيظهر محتوى قابل للاستبدال. وبالنتيجة، يتم تعريف محتوى قابل للاستبدال في صفحات محتوى. بعد تعريف ContentPlaceHolder عناصر التحكم، قد يبدو صفحة رئيسية كما يلي.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 
    1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server" >
    <title>Master page title</title>
</head>
<body>
    <form id="form1" runat="server">
        <table>
           <tr>
               <td><asp:contentplaceholder id="Main" runat="server" /></td>
               <td><asp:contentplaceholder id="Footer" runat="server" /></td>
           </tr>
        </table>
    </form>
</body>
</html>

صفحات المحتوى

تعريف المحتوى عناصر تحكم العنصر النائب صفحة رئيسية عن طريق إنشاء محتوى صفحات فردية, وهي عبارة عن صفحات ASP.NET (ملفات aspx. والملفات, بشكل اختياري الخلفية التعليمات البرمجية) المرتبطة بصفحة رئيسية محددة. The binding is established in the content page's @ Page directive by including a MasterPageFile attribute that points to the master page to be used. For example, a content page might have the following @ Page directive, which binds it to the Master1.master page.

<%@ Page Language="C#" MasterPageFile="~/MasterPages/Master1.master" Title="Content Page"%>

في الصفحة "محتوى" ، إنشاء المحتوى بإضافة Content تعيين لهم وعناصر التحكم ContentPlaceHolder عناصر التحكم على صفحة رئيسية. على سبيل المثال، قد يكون لديك صفحة رئيسية العناصر النائبة الخاصة بالمحتوى تسمى Main و Footer. في الصفحة "محتوى" ، يمكنك إنشاء نوعين Content يتحكم الذي تم تعيينه إلى ContentPlaceHolder عنصر التحكم Main الآخر بتعيين ContentPlaceHolder عنصر التحكم Footer، كما هو موضح في الشكل التالي.

استبدال العنصر النائب المحتوى

الرسم MasterPagesMerge

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

قد يبدو صفحة محتوى كما يلي.

<% @ Page Language="VB" MasterPageFile="~/Master.master" Title="Content Page 1" %>
<asp:Content ID="Content1" ContentPlaceHolderID="Main" Runat="Server">
    Main content.
</asp:Content>
    
<asp:Content ID="Content2" ContentPlaceHolderID="Footer" Runat="Server" >
    Footer content.
</asp:content>

[C#]

<% @ Page Language="C#" MasterPageFile="~/Master.master" Title="Content Page 1" %>
<asp:Content ID="Content1" ContentPlaceHolderID="Main" Runat="Server">
    Main content.
</asp:Content>
    
<asp:Content ID="Content2" ContentPlaceHolderID="Footer" Runat="Server" >
    Footer content.
</asp:content>

The @ Page directive binds the content page to a specific master page, and it defines a title for the page that will be merged into the master page. لاحظ أن صفحة محتوى يحتوي على علامات أخرى خارج Content عناصر التحكم. (الصفحة الرئيسية يجب أن يحتوي على head عنصر مع السمة runat="server" بحيث يمكن دمجها الإعداد العنوان في وقت التشغيل.)

يمكنك إنشاء عدة صفحات رئيسية لتعريف تخطيطات مختلفة لأجزاء مختلفة من الموقع الخاص بك و مجموعة أخرى من صفحات المحتوى لكل صفحة رئيسية.

عودة إلى الأعلى

توفر وظائف تقليدي للمطورين إنشاء بواسطة نسخ التعليمات البرمجية الموجودة النص، الصفحات الرئيسية و التحكم العناصر بشكل متكرر; باستخدام مجموعات الإطارات; باستخدام بتضمين الملفات العناصر الشائعة; باستخدام عناصر تحكم ASP.NET المستخدم; وما إلى ذلك. فوائد صفحات رئيسية ما يلي:

  • تسمح لك الواحد مركزة خلفية الوظائف الشائعة الصفحات بحيث يمكنك إجراء التحديثات في مكان واحد فقط.

  • كانت تسهل لإنشاء مجموعة واحدة من عناصر التحكم والتعليمات البرمجية النتائج وتطبيق لمجموعة من الصفحات. على سبيل المثال، يمكنك استخدام عناصر التحكم على الصفحة الرئيسية لإنشاء قائمة التي تنطبق على كافة الصفحات.

  • وهي تمنحك تفصيلية التحكم في تخطيط الصفحة الأخيرة عن طريق السماح لك بالتحكم في كيفية تقديم عناصر تحكم العنصر النائب.

  • وهي توفر طراز كائن يسمح لك بتخصيص الصفحة الرئيسية من صفحات المحتوى الفردية.

عودة إلى الأعلى

وقت التشغيل معالجة الصفحات الرئيسية في التسلسل التالي:

  1. طلب المستخدمون صفحة عن طريق كتابة محدد موقع المعلومات (URL) لصفحة المحتوى.

  2. When the page is fetched, the @ Page directive is read. تتم قراءة الصفحة الرئيسية وكذلك إذا التوجيه بالرجوع إلى صفحة رئيسية. إذا كانت هذه هي المرة الأولى التي طلبتها الصفحات يتم تصنيف كلا الصفحتين.

  3. يتم دمج الصفحة الرئيسية التي تحتوي على محتوى مُحدث في شجرة وحدة التحكم من صفحة المحتوى.

  4. المحتوى الفردية Content يتم دمج عناصر التحكم في المطابقة ContentPlaceHolder التحكم في الشريحة الرئيسية الصفحة.

  5. يتم تقديم الصفحة المدمجة الناتجة إلى المستعرض.

يتم توضيح العملية في الرسم التخطيطي التالي.

الصفحات الرئيسية في وقت التشغيل

الرسم MasterPagesMerge

من منظور المستخدم المدمجة الرئيسية وصفحات المحتوى صفحة مفردة منفصلة. يكون محدد موقع المعلومات الخاص بالصفحة التي صفحة المحتوى.

تعمل صفحتين من منظور برمجة كحاويات منفصلة لعناصر التحكم الخاصة بهم. يتصرف صفحة المحتوى كحاوية للصفحة الرئيسية. ومع ذلك، يمكنك الرجوع أعضاء الصفحة الرئيسية العمومية من التعليمات البرمجية في الصفحة "محتوى" ، كما هو موضح في المقطع التالي.

لاحظ أن الصفحة الرئيسية يصبح جزءاً من صفحة المحتوى. ساري المفعول الصفحة الرئيسية يتصرف في الكثير يتصرف عنصر تحكم مستخدم بالطريقة نفسها — كتابع محتوى الصفحة "و" كحاوية داخل تلك الصفحة. في هذه الحالة، ولكن، الصفحة الرئيسية هي الحاوية لكافة عناصر التحكم الملقم التي يتم تقديمها إلى المستعرض. شجرة عناصر التحكم الرئيسية المدمجة وصفحة المحتوى يبدو شيء كما يلي:

Page
    Master Page
        (Master page markup and controls)
        ContentPlaceHolder
            Content page markup and server controls
        (Master page markup and controls)
        ContentPlaceHolder
            Content page markup and server controls
        (Master page markup and controls)

تبسيط هذا الرسم التخطيطي; إذا لم يكن محتوى الصفحة المقابلة Content عناصر تحكم، صفحة رئيسية قد يكون لدى العلامات وعناصر التحكم في ContentPlaceHolder عناصر التحكم.

بشكل عام، هذه البنية له أي تأثير على كيفية إنشاء الصفحات الخاصة بك أو البرنامج عليها. ومع ذلك، في بعض الحالات إذا قمت بتعيين خاصية مستوى الصفحة على الصفحة الرئيسية ذلك قد على سلوك صفحة المحتوى حيث تكون الصفحة الرئيسية الأصل الأقرب لعناصر التحكم على الصفحة. على سبيل المثال، إذا قمت بتعيين EnableViewState الخاصية على صفحة المحتوى إلى true ولكن قم بتعيين الخاصية نفس إلى false في الصفحة الرئيسية بحالة العرض سيتم بفاعلية تعطيل لأن الإعداد على الصفحة الرئيسية نافذة الأولوية.

عودة إلى الأعلى

عندما يتم طلب محتوى صفحة يتم دمج المحتوى بواسطة الصفحة الرئيسية ويتم تشغيل الصفحة في سياق صفحة المحتوى. على سبيل المثال، إذا حصلت على CurrentExecutionFilePath خاصية HttpRequest كائن ما إذا كان في رمز صفحة المحتوى أو في التعليمات البرمجية "الصفحة الرئيسية المسار يمثل موقع صفحة المحتوى.

الصفحة الرئيسية وصفحة المحتوى غير متوفر لديك في نفس المجلد. As long as the MasterPageFile attribute in the content page's @ Page directive resolves to a .master page, ASP.NET can merge the content and master pages into a single rendered page.

الرجوع إلى الموارد الخارجية

الصفحة الرئيسية ورمز صفحة المحتوى يمكن أن تحتوي على عناصر التحكم والعناصر التي تشير إلى الموارد الخارجية. على سبيل المثال، ربما كلاهما يحتوي على عناصر تحكم الصور التي تشير إلى ملفات صور أو قد يحتوي على نقاط ارتساء التي تشير إلى الصفحات الأخرى.

سياق الصفحات الرئيسية والمحتوى المدمجة التي صفحة المحتوى. قد يؤثر ذلك على كيفية تحديد URLs بحثاً عن الموارد، مثل ملفات الصور والصفحات الهدف في نقاط ارتساء.

عناصر تحكم الخادم

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

يمكن تعديل ASP.NET محددات مواقع المعلومات (URL) في الحالات التالية:

  • محدد موقع المعلومات (URL) خاصية عنصر تحكم ASP.NET الملقم.

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

عناصر أخرى

لا يمكن تعديل ASP.NET محددات مواقع المعلومات على العناصر التي ليست عناصر تحكم الملقم. على سبيل المثال، إذا كنت تستخدم img عنصر على صفحة رئيسية ومجموعة الخاصة به src لن يقوم بتعديل سمة إلى URL ASP.NET محدد موقع المعلومات (URL). في هذه الحالة، يمكن حل في سياق صفحة المحتوى محدد موقع المعلومات (URL) وقم بإنشاء محدد موقع المعلومات (URL) وفقاً لذلك.

بشكل عام عند العمل مع العناصر على صفحات رئيسية, فمن المستحسن استخدام عنصر تحكم ملقم حتى للعناصر التي لا تتطلب ملقم التعليمات البرمجية. على سبيل المثال، بدلاً من استخدام img عنصر استخدام Image تحكم الملقم. وبهذه الطريقة، ASP.NET يمكن حل محددات مواقع المعلومات (URL) بشكل صحيح ثم يمكنك تجنب المشكلات الصيانة التي قد تنشأ إذا قمت بنقل صفحة رئيسية أو المحتوى.

لمزيد من المعلومات حول تعيين مسارات الخادم عناصر تحكم ASP.NET راجع مسارات موقع ويب ASP.NET.

عودة إلى الأعلى

لا يمكنك تطبيق سمة ASP.NET مباشرة إلى صفحة رئيسية. If you add a theme attribute to the @ Master directive, the page will raise an error when it runs.

على الرغم من ذلك، يتم تطبيق السمات على الصفحات الرئيسية هذه الحالات:

  • إذا تم تعريف سمة في صفحة محتوى. يتم حل الصفحات الرئيسية في سياق محتوى الصفحات بحيث يتم تطبيق السمة صفحة محتوى على الصفحة الرئيسية أيضاً.

  • إذا تم تكوين موقع ككل لاستخدام سمة عن طريق تضمين تعريف سمة في صفحات عنصر (مخطط إعدادات ASP.NET) عنصر.

لمزيد من المعلومات، راجع سمات و أسطح خارجية asp.net.

عودة إلى الأعلى

يمكنك إرفاق صفحات محتوى صفحة رئيسية في ثلاثة مستويات:

  • مستوى الصفحة   يمكنك استخدام توجيه صفحة في كل صفحة محتوى ربط إلى صفحة رئيسية كما هو موضح في المثال التالي من التعليمات البرمجية.

    <%@ Page Language="VB" MasterPageFile="MySite.Master" %> 
    
    

    <%@ Page Language="C#" MasterPageFile="MySite.Master" %> 
    
    
  • مستوى التطبيق   جعل أحد إعدادات في pages عنصر ملف التكوين للتطبيق (Web.config) ، يمكنك تحديد ربط صفحات ASP.NET كافة (ملفات .aspx) في التطبيق تلقائياً إلى صفحة رئيسية. قد يبدو العنصر كما يلي.

    <pages masterPageFile="MySite.Master" />
    
    

    إذا كنت تستخدم هذه الاستراتيجية لكافة صفحات ASP.NET في التطبيق ذات Content يتم دمج عناصر التحكم مع الصفحة الرئيسية المحددة. (في حالة عدم احتواء صفحة ASP.NET Content عناصر تحكم الصفحة الرئيسية لم يتم تطبيق.)

  • مستوى المجلد   هذه الاستراتيجية يشبه الربط في مستوى التطبيق، إلا أنه في إجراء الإعداد في ملف Web.config في مجلد واحد فقط. قم بتطبيق عمليات ربط الصفحة الرئيسية على صفحات ASP.NET في هذا المجلد.

عودة إلى الأعلى

Title

التعريف

مشاركة الصفحات الرئيسية في ‏‫Visual Studio

وصف كيفية استخدام نفس الصفحات الرئيسية في عدة مواقع ويب أو المشاريع.

الصفحات ASP.NET الرئيسية المتداخلة

توضح هذه المقالة كيفية تضمين صفحة رئيسية واحدة داخل آخر.

العمل مع صفحات ASP.NET الرئيسية برمجياً

توفير معلومات حول كيفية الوصول إلى عناصر الصفحة الرئيسية في التعليمات البرمجية.

تحرير الصفحة الرئيسية في The Visual Web Developer Designer

وصف كيفية استخدام مصمم صفحة ويب Visual Studio لإنشاء الصفحات الرئيسية وصفحات المحتوى وتحريره.

الإرشادات التفصيلية: إنشاء واستخدام الصفحات ASP.NET الرئيسية في ‏‫Visual Web Developer

توفير برنامج تعليمي خطوة بخطوة حول كيفية إنشاء صفحة رئيسية وصفحات المحتوى.

الأحداث في ASP.NET الرئيسية و محتويات الصفحات

توضح هذه المقالة كيفية تشغيل أحداث صفحة والتحكم في المدمجة الرئيسية وصفحات المحتوى.

الصفحات ويب asp.net

توفير ارتباطات لمواضيع لإنشاء صفحات ويب ASP.NET.

عودة إلى الأعلى

إضافات المجتمع

إضافة
إظهار:
© 2014 Microsoft