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.ExtractTemplateRows الخاصية

Visual Studio 2010

استخدم Tableالحقل إلى تمثل DataListاسم الأمر.

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

public virtual bool ExtractTemplateRows { get; set; }
<asp:DataList ExtractTemplateRows="True|False" />

قيمة الخاصية

النوع: System.Boolean
true if the rows of a Table control, defined in each template of a DataList control, are extracted and displayed; otherwise, false. القيمة الافتراضية هي false.

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

Use the ExtractTemplateRows property to specify whether the rows of a Table control defined in each template of a DataList control are extracted and displayed. You can الوصول الجميع العنصر أنواع, including the عنوان, تذييل الصفحة, و فاصل عناصر, through the DataList مجموعة. يمنع the DataList أسلوب إلى يخصص how عناصر التحكم are تاريخ الإنشاء أو تمت الإضافة إلى the عنصر تحكم.

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

يمنع the true أسلوب إلى يخصص قوالب for a Table عنصر تحكم. DataList إنشاء النمط الإفتراضى كائن يتم استخدامها داخليا بواسطة المتعلقة بعنصر التحكم إلى تطبيق النمط على كافة الخصائص. A that يحتوي على the الافتراضي النمط خصائص for the عنصر تحكم. The Table أسلوب هو used primarily بواسطة عنصر تحكم developers في deriving a مخصص implementation من the عنصر تحكم. The following تعليمات برمجية مثال demonstrates how إلى يمنع the System.Web.UI.HtmlControls.HtmlTable أسلوب في a مخصص عنصر تحكم الخادم so that it دوماً displays أفقي شبكة lines مع لا خلية تباعد في the control.

When you create a cell for a Table control in a template, you can use the ColumnSpan property of the TableCell object to control the number of columns the cell spans. A RowSpan that represents the specified نوع of the العنصر إلى إنشاء.

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

The RepeatColumns, RepeatDirection, and RepeatLayout properties do not affect the appearance of the DataList control when this property is set to true.

The ExtractTemplateRows أسلوب هو used primarily by عنصر تحكم developers in creating a custom implementation of the Table عنصر تحكم. DataList

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

نموذج تعليمات برمجية التالي يستخدم طراز تعليمات برمجية أحادية و قد لا تعمل بشكل صحيح في حالة نسخ مباشرة في التعليمات برمجية-خلف ملف. يجب أن يتم نسخ نموذج تعليمات برمجية هذه في ملف نصي فارغ له ملحق.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">
    <script runat="server">

        private ICollection CreateDataSource()
        {
            DataTable dt = new DataTable();
            DataRow dr;

            dt.Columns.Add(new DataColumn("StringValue", 
                typeof(string)));
            dt.Columns.Add(new DataColumn("PriceValue", 
                typeof(string)));
            dt.Columns.Add(new DataColumn("DescriptionValue", 
                typeof(string)));

            for (int i = 1; i < 11; i++)
            {
                dr = dt.NewRow();
                dr[0] = "Item " + i.ToString();
                dr[1] = String.Format("{0:C}", (1.23 * (i + 1)));
                dr[2] = "Description for Item " + i.ToString();
                dt.Rows.Add(dr);
            }

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

        private void Page_Load(Object sender, EventArgs e)
        {
            if (!IsPostBack)
            {
                DataList1.DataSource = CreateDataSource();
                DataList1.DataBind();
            }
        }
    </script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
        ExtractTemplateRows Example
    </title>
</head>
<body>
    <form id="form1" runat="server">

    <h3>DataList ExtractTemplateRows Example</h3>

    <asp:DataList id="DataList1" runat="server"
        BorderColor="black"
        CellPadding="3"
        Font-Names="Arial, Helvetica"
        Font-Size="9pt"
        ExtractTemplateRows="true"
        GridLines="Both">

        <HeaderStyle BackColor="LightBlue" />
        <AlternatingItemStyle BackColor="#efefef" />

        <HeaderTemplate>
        <asp:Table id="Table1" runat="server">
            <asp:TableRow>
                <asp:TableHeaderCell
                    ColumnSpan="2">
                    Items List
                </asp:TableHeaderCell>
            </asp:TableRow>
        </asp:Table>
        </HeaderTemplate>

        <ItemTemplate>
            <asp:Table id="Table2" runat="server">
                <asp:TableRow>
                    <asp:TableCell 
                        Text='<%# Eval("StringValue") %>'>
                    </asp:TableCell>
                    <asp:TableCell 
                        HorizontalAlign="Right"
                        Text='<%# Eval("PriceValue") %>'>
                    </asp:TableCell>
                </asp:TableRow>
                <asp:TableRow>
                    <asp:TableCell
                        ColumnSpan="2" 
                        Text='<%# Eval("DescriptionValue") %>'>
                    </asp:TableCell>
                </asp:TableRow>
            </asp:Table>
        </ItemTemplate> 
    </asp:DataList>

   </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
إظهار: