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 الفئة

Visual Studio 2010

كما بالمثال السابق، وبيانات هو يمكن معالجته في ذاكرة باستخدام الكائنات التي تم استردادها مع الأسلوب.

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

[ControlValuePropertyAttribute("SelectedValue")]
public class DataList : BaseDataList, INamingContainer, 
	IRepeatInfoUser
<asp:DataList />

في هذا الموضوع:

مقدمة

خاصية داخلية هو متوافقة مع بيانات ورقة النمط XSL، لأن ذلك من تنسيق ورقة الأنماط في أي شكل من الأشكال وتجاهل المسافات البادئة بالحرف هو sues مثل حشوة حرف علامة اقتباس.DataList إذا كان كلا DataListو تعيين الخصائص، الخاصية تأخذ الأسبقية والبيانات الموجودة في ملف ورقة أنماط XSL (.xsl) هو استخدامها بدلاً من عناصر أوراق الأنماط المحددة في الخاصية.

قوالب

إذا كان تعبير XPath هو تعيينه باستخدام DataListخاصية، فإنه هو تطبيقه بعد بيانات XML هو تحويل. يلي تعليمات برمجية مثال يوضح كيفية استخدام عنصر تحكم يحتوي templated تحويل عنصر تحكم لعرض بيانات XML.

اسم القالب

الوصف

AlternatingItemTemplate

ورقة النمط الذي يقوم بإجراء التحويل هو تعريف مضمن بواسطة DataListخاصية بيانات مصدر عنصر التحكم. توفير قائمة الوسائط XSLT المستخدمة مع ورقة الأنماط المعرفة من قبل ItemTemplateأو خصائص إلى القيام تحويل على بيانات XML.

EditItemTemplate

DataList الكائن الذي يحتوي على معلمات XSLT والكائنات ليتم تطبيقها على بيانات XML عند هو تحميلها من قبل عنصر التحكم. توفير قائمة الوسائط XSLT المستخدمة مع ورقة الأنماط المعرفة من قبل ItemTemplateأو خصائص إلى القيام تحويل على بيانات XML.

FooterTemplate

تعيين DataListخاصية عند حدث هو raهوed للتأكد من المعلمات XSLT متوفرة في الوقت الذي التحويل XSLT هو المطبق على بيانات XML. يلي تعليمات برمجية مثال يوضح كيفية استخدام مع تحويل عنصر تحكم لعرض بيانات XML.

HeaderTemplate

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

ItemTemplate

تحويل بيانات XML هو تنفيذها باستخدام ورقة الأنماط التالية.DataList

SelectedItemTemplate

تحدد ملف الاسم من لغة صفحات الأنماط الموسعة (XSL) ملف (.xsl) الذي يعرف تحويل XSLT سيتم تنفيذه تشغيل بيانات XML التي تم إدارتها بواسطة DataListعنصر التحكم. توفير قائمة الوسائط XSLT المستخدمة مع ورقة الأنماط المعرفة من قبل ItemTemplateأو خصائص إلى القيام تحويل على بيانات XML.

SeparatorTemplate

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

التحويل هو تنفيذ باستخدام ورقة الأنماط المشار إليها بواسطة ItemTemplateالخاصية.DataList يمكنك اختيارياً توفير وسيطات التحويل ورقة الأنماط استخدام DataList.

الحصول أو تعيين حظر من البيانات لغة صفحات الأنماط الموسعة (XSL) الذي يعرف تحويل XSLT سيتم تنفيذه تشغيل بيانات XML التي تم إدارتها بواسطة عنصر تحكم.

The XSL النمط ورقة that performs the XML transformation has the following بنية:DataList يسرد الجدول التالي خصائص النمط آخر.

قبل ورقة النمط التي هو المعرفة بواسطة الخاصية أو تعريفه بواسطة الخاصية هو المطبق على بيانات XML.

الوصف

AlternatingItemStyle

مؤشر the DataList حدث إلى التعيين the خاصية مع an كائن قبل the عنصر تحكم performs an XML transformation.

EditItemStyle

بالإضافة إلى ذلك، تستخدم ورقة الأنماط لتحويل الوسيطات التي تم تمريرها إلى البيانات المصدر عنصر تحكم في DataListفي وقت التشغيل.

FooterStyle

The تعليمات برمجية مثال demonstrates how إلى pass the DataList كائن إلى the بيانات التحكم بالمصادر بواسطة handling the حدث مع a مخصص معالج الأحداث.

HeaderStyle

التحويل من بيانات XML يتم إجراؤها بواسطة ورقة الأنماط التالية:DataList

ItemStyle

تعيين تعبير XPath لتطبيقها بيانات XML يحتويها DataListالخاصية أو بملف XML المشار إليها بواسطة الخاصية.

SelectedItemStyle

A سلسلة that represents an XPath تعبير that can be used إلى عامل تصفية the بيانات contained بواسطة the DataList خاصية أو بواسطة the ملف XML indicated بواسطة the خاصية.

SeparatorStyle

For المزيد معلومات تشغيل XPath بيانات-ربط expressions, see DataList.

The following تعليمات برمجية مثال demonstrates how إلى استخدم an عنصر تحكم مع a templated عنصر تحكم إلى عرض XML بيانات that has been filtered using an XPath تعبير. في ترتيب هو سبيل المثال، بناء جملة XPath هو المستخدمة لتصفية بيانات XML عند الخاصية لعنصر تحكم مصدر البيانات هو تعيين، وأيضا ربط عناصر قالب عنصر التحكم إلى بيانات XML.

الخصائص

الوصف

ShowFooter

تطبيق كائن DataListالذي يمكن أن يكون منضماً إلى بيانات المصدر.

ShowHeader

يحصل العرض المقترنة بمصدر بيانات لمصدر بيانات المسمى عنصر تحكم.DataList

سلسلة موضعي XSL الذي يعرف تحويل XML المراد تنفيذها تشغيل بيانات الموجودة في أو الخصائص.

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

تطبيق كائن DataListالتي تحتوي على أسماء الذي يمثل قائمة عرض الكائنات المقترنة RepeatLayoutالكائن. RepeatLayout.Table إذا كانت المجموعة هو مجموعة منDataListالالكائنات؛ otherwهوe،RepeatLayout.Flow.DataList

الأمان

الحصول أو تعيين القيمة المفتاح ذاكرة تخزين مؤقت لمصدر بيانات عنصر تحكم من الولاية العرض، أو إضافة المفتاح ذاكرة تخزين مؤقت لعرض الالولاية.DataList

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

This عنصر تحكم can be used إلى عرض مستخدم إدخال, which might تضمين malicious العميل برنامج نصي. فحص أي معلومات that هو sent من a العميل for تنفيذي برنامج نصي, SQL statements, أو غير ذلك تعليمات برمجية قبل displaying it في your تطبيق. القيمة المفتاح ذاكرة تخزين مؤقت، أو سلسلة فارغ إذا كان مفتاح ذاكرة تخزين مؤقت هو ليس في طريقة العرض لالولاية. يوفر ASP.NET ميزة التحقق من صحة إدخال طلب إلى حظر برنامج نصي و HTML في إدخال مستخدم.

For more information about security, see تأمين عناصر التحكم القياسية, كيفية: حماية من عمليات استغلال البرنامج النصي في تطبيق ويب من خلال تطبيق ترميز HTML إلى سلاسل, and التحقق من صحة إدخالات المستخدم في صفحات ASP.NET على ويب.

بناء جملة مصرحة

<asp:DataList
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExtractTemplateRows="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingItemStyle />
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemStyle />
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <ItemStyle />
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <SelectedItemStyle />
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
        <SeparatorStyle />
        <SeparatorTemplate>
            <!-- child controls -->
        </SeparatorTemplate>
</asp:DataList>

TopicLocation
كيفية القيام بما يلي: تخصيص العناصر الموجودة في عنصر تحكم خادم الويب DataList بشكل ديناميكيdv_vwdcon
الإرشادات التفصيلية: إنشاء واستخدام الصفحات ASP.NET الرئيسية في ‏‫Visual Web Developerdv_vwdcon
كيفية القيام بما يلي: السماح للمستخدمين بحذف العناصر في قائمة بيانات خادم ويب عناصر التحكمdv_vwdcon
كيفية القيام بما يلي: قم بإنشاء قوالب عنصر تحكم ويب ASP.NET بشكل إلزاميdv_vwdcon
كيفية القيام بما يلي: حدد أفقي أو تخطيط عمودي في قائمة بيانات ويب الخادم عناصر التحكمdv_vwdcon
كيفية القيام بما يلي: قم بإضافة عناصر تحكم إلى صفحة ويب ASP.NET طريقة برمجيةdv_vwdcon
الإرشادات التفصيلية: عرض وتنسيق بيانات مع عنصر تحكم قائمة البيانات لخادم الويبdv_vwdcon
كيفية القيام بما يلي: إنشاء قوالب عناصر تحكم خادم الويب بإستخدام المصممdv_vwdcon
كيفية القيام بما يلي: إنشاء قوالب عنصر تحكم خادم ويب ASP.NET ديناميكياًdv_vwdcon
كيفية القيام بما يلي: إسمح للمستخدمين بتحرير عناصر في DataList عناصر تحكم خادم ويبdv_vwdcon
الإرشادات التفصيلية: إنشاء صفحة ويب لعرض بيانات XMLdv_vwdcon
كيفية القيام بما يلي: الربط إلى بيانات موجودة في عنصر تحكم قالبdv_vwdcon
الإرشادات التفصيلية: ربط بيانات إلى كائن أعمال مخصصdv_vwdcon
كيفية القيام بما يلي: إسمح للمستخدمين بتحديد عناصر في DataList عناصر تحكم خادم ويبdv_vwdcon
كيفية القيام بما يلي: قم بإضافة ويب قائمة بيانات الخادم عناصر التحكم صفحة ويب ASP.NETdv_vwdcon
كيفية القيام بما يلي: تخصيص عناصر DataList في وقت التشغيلdv_vwdcon
كيفية القيام بما يلي: الربط بالبيانات في عنصر التحكم في القالب في ‏‫Visual Studiodv_vwdcon
الإرشادات التفصيلية: إنشاء صفحات ويب رئيسية/تفصيلية في ‏‫Visual Studiodv_vwdcon
كيفية القيام بما يلي: الاستجابة إلى زر الأحداث في عناصر تحكم ربط البياناتdv_vwdcon
كيفية القيام بما يلي: قم بتحديد سير أو تنسيق جدول في قائمة بيانات ويب الخادم عناصر التحكمdv_vwdcon
كيفية القيام بما يلي: الاستجابة إلى Butإلىn الأحداث في قائمة بيانات أو عناصر إعادة تقويةdv_vwdcon
الإرشادات التفصيلية: عرض مستند XML في نماذج ويب الصفحة استخدام تحويلاتdv_vwdcon

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">
<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();
         }

      }

   </script>

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

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

      <h3>DataList Example</h3>

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

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

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <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" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

      </asp:DataList>

   </form>

</body>
</html>



يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: