This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

DataList.SeparatorTemplate الخاصية

Visual Studio 2010

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

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

[BrowsableAttribute(false)]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[TemplateContainerAttribute(typeof(DataListItem))]
public virtual ITemplate SeparatorTemplate { get; set; }
<asp:DataList>
	<SeparatorTemplate>ITemplate</SeparatorTemplate>
</asp:DataList>

قيمة الخاصية

النوع: System.Web.UI.ITemplate
على سبيل المثال، إذا كان System.Web.UI.ITemplateخاصية هو تعيين إلى DataList، عناصر الموجودة في هي عنصر التحكم dهوplayed في أعمدة الثلاثة، كما في الجدول التالي. القيمة الافتراضية هي null.

If this خاصية هو التعيين إلى SeparatorTemplate, the عناصر في the قائمة are displayed في صفوف تم تحميله من اليسار لليمين, then الأعلى إلى أسفل, until الجميع عناصر are rendered. DataList الحصول أو تعيين ما إذا كان DataListعنصر تحكم يعرض عمودياً أو أفقياً. For مثال, if the DataList خاصية هو التعيين إلى SeparatorStyle, the عناصر of the عنصر تحكم are displayed في صفوف of three عناصر each, كـ في the following جدول.

The following تعليمات برمجية مثال demonstrates how إلى استخدم the <SeparatorTemplate> خاصية إلى specify the الاتجاه في which the DataList عنصر تحكم هو displayed. ثم يمكنك سرد المحتويات قالب بين فتح وإغلاق <SeparatorTemplate>علامات.

ملاحظة تنبيهتنبيه

This عنصر تحكم can be used إلى عرض مستخدم إدخال, which might تضمين malicious العميل برنامج نصي. استخدم هذه construcإلىr إلى يهيّئ مثيل جديد فئة استخدام فهرس الصف المحدد. لمزيد من المعلومات، راجع تأمين عناصر التحكم القياسية ، كيفية: حماية من عمليات استغلال البرنامج النصي في تطبيق ويب من خلال تطبيق ترميز HTML إلى سلاسل ، و التحقق من صحة إدخالات المستخدم في صفحات ASP.NET على ويب.

The following code example demonstrates how to use the SeparatorTemplate property to control the contents of the separator between each item in the DataList control.

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

نموذج تعليمات برمجية التالي يستخدم طراز تعليمات برمجية أحادية و قد لا تعمل بشكل صحيح في حالة نسخ مباشرة في التعليمات برمجية-خلف ملف. يجب أن يتم نسخ نموذج تعليمات برمجية هذه في ملف نصي فارغ له ملحق.aspx. لمزيد من المعلومات حول نموذج تعليمات برمجية "نماذج ويب"، راجع طراز رمز صفحة ASP.NET على ويب.



<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));

         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }

      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for the separator section of
         // the DataList control.
         ItemsList.SeparatorStyle.BackColor = 
             System.Drawing.Color.FromName(ItemList.SelectedItem.Value);

      }

   </script>

<head runat="server">
    <title>DataList SeparatorTemplate and SeparatorStyle Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataList SeparatorTemplate and SeparatorStyle Example</h3>

      Select a background color for the separator between 
      items in the DataList.

      <br /><br />

      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowFooter="True"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <ItemStyle BackColor="Silver">
         </ItemStyle>

         <AlternatingItemStyle BackColor="DarkGray">
         </AlternatingItemStyle>

         <SeparatorStyle BackColor="White">
         </SeparatorStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>

         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage"
                 AlternatingText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>'
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

         <SeparatorTemplate>

            <asp:Image id="SeparatorImage"
                 GenerateEmptyAlternateText='true' 
                 ImageUrl="SeparatorImage.jpg"
                 runat="server"/>

         </SeparatorTemplate>

      </asp:DataList>

      <hr />

      <table cellpadding="5">

         <tr>

            <td>

               Separator BackColor:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ItemList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>

      </table>

   </form>

</body>
</html>



نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: