مشاركة عبر


عنصر تحكم خادم مضمّن قالب بناء الجملة

تحديد المحتوى الذي سيتم تضمينه ، و أنه كيف سيكون ترتيب تطبيق النمط داخل عناصر تحكم خادم الـ ASP.NET التي تدعم القوالب.

<templatename>
   Server control, data-binding syntax, other valid markup
</templatename>

علامات ترميز

  • templatename
    اسم قالب عنصر تحكم خادم الـ ASP.NET.

ملاحظات

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

العديد من عناصر تحكم خادم الويب للـ ASP.NET التي تدعم القوالب (على سبيل المثال، Repeater، DataList، GridView، FormView، MultiView، LoginView, و Menuالتحكم بكل القوالب ، كما تفعل منطقة "أجزاء ويب" ضمن WebPartZoneو CatalogZone). لاحظ أنه يمكن أن يتم تعريف القوالب التي تم تعريفها بشكل خاص لعنصر التحكم فعلياً بعنصر التحكم هذا.

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

لتحديد كيفية ظهور المحتوى داخل قالب, تقوم بتعريف عناصر إضافية ضمن علامات القالب. للترميز الإضافي الذي يمكن أن يتألف من علامات HTML ، عناصر تحكم ASP.NET ، و التعبيرات الموضعية من جانب الخادم أو كتل التعليمات البرمجية. لمزيد من المعلومات حول كيفية استخدام القوالب الموضعية ، انظر قوالب عناصر التحكم ملقم ويب ASP.NET.

يمكنك تعريف القوالب الخاصة بك عند تطوير عناصر تحكم الخادم المخصصة. لمزيد من المعلومات حول عناصر التحكم التي تعرّف نمط القوالب المضمن واستخدام التطوير راجع كيفية: إنشاء عناصر تحكم المستخدم ASP.NET Templated.

مثال

يوضح مثال التعليمات البرمجية التالي كيفية تعريف المتغير HeaderTemplate، AlternatingItemTemplate، ItemTemplate, و FooterTemplateالقوالب في Repeaterتحكم خادم الويب. يقترن كل من هذه القوالب مع خاصية Repeaterالفئة.

<%@ Page Language="C#" %>
<html>
 <head>
    <script language="C#" runat="server">
       void Page_Load(Object Sender, EventArgs e) {
 
          if (!IsPostBack) {
             ArrayList values = new ArrayList();
 
             values.Add("Apple");
             values.Add("Orange");
             values.Add("Pear");
             values.Add("Banana");
             values.Add("Grape");
 
             Repeater1.DataSource = values;
             Repeater1.DataBind();
          }
       }
    </script>
 
 </head>
 <body>
 
    <h3><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>
<%@ Page Language="VB" %> 
<html>
<head>
<script language="VB" runat="server">

        Sub Page_Load(Sender As Object, e As EventArgs)
            
            If Not IsPostBack Then
                Dim values As New ArrayList()
                
                values.Add("Apple")
                values.Add("Orange")
                values.Add("Pear")
                values.Add("Banana")
                values.Add("Grape")
                
                Repeater1.DataSource = values
                Repeater1.DataBind()
            End If
        End Sub
</script>
 
 </head>
 <body>
 
    <h3><font face="Verdana">Repeater Example</font></h3>
 
    <form runat=server>
 
       <b>Repeater1:</b>
       <p>
         
       <asp:Repeater id=Repeater1 runat="server">
             
             
          <HeaderTemplate>
             <table border=1>
          </HeaderTemplate>
 
          <AlternatingItemTemplate>
             <tr>
                <td><b> <%# Container.DataItem %> </b> </td>
             </tr>
          </AlternatingItemTemplate>
 
          <ItemTemplate>
             <tr>
                <td> <%# Container.DataItem %> </td>
             </tr>
          </ItemTemplate>
 
          <FooterTemplate>
             </table>
          </FooterTemplate>
             
       </asp:Repeater>
       <p>
         
    </form>
 </body>
 </html>    

راجع أيضًا:

المهام

كيفية: إنشاء عناصر تحكم المستخدم ASP.NET Templated

المرجع

بناء جملة عنصر تحكم خادم مخصص

المبادئ

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