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.

ListView الفئة

Visual Studio 2010

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

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

[ControlValuePropertyAttribute("SelectedValue")]
[ToolboxBitmapAttribute(typeof(ListView), "ListView.bmp")]
public class ListView : DataBoundControl, INamingContainer, 
	IPageableItemContainer, IPersistedSelector, IDataKeysControl, IDataBoundListControl, IDataBoundControl
<asp:ListView />

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

مقدمة

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

يدعم عنصر التحكم ListView الميزات التالية:

  • Support for binding to data source controls such as SqlDataSource, LinqDataSource, and ObjectDataSource.

  • سلوك خط تسطير الارتباطات التي تم إنشاؤها بواسطة ، ، و عناصر تحكم هو متأثرة بتعيين و خصائص لعنصر التحكم.

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

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

  • إعادة تعيين الجميع خصائص إلى الولاية إلغاء تعيين ومسح الولاية العرض.

  • DataPager الخصائص unset عندالكائن هو تاريخ الإنشاء.

  • عند الخاصية هو أولاً تعيين، القيمة هو تمت الإضافة إلى عرض الحالة.

  • الوصول المبرمج إلى ListViewطراز الكائن شكل حيوي بتعيين الخصائص، والأحداث hوle، و. هكذا

  • أسلوب هو المستخدمة لتعيين الجميع خصائص unset لالولاية وقم بإزالة أية إدخالات في الولاية العرض.

وتتم يعيد تعيين المعاملة الخصائص التالية:نظرة عامة عناصر تحكم ملقم ويب ربط البيانات ASP.NET

قوالب

ListView الفئة هو تستخدم لتخزين بيانات حدث التي تم تمريرها إلى معالج حدث للأحداث الموجودة في الجدول التالي. يحدث عند عنصر قائمة هو النقر فوقه.ItemTemplate Th هو حدث هو استخداماً لمزامنة عنصر عنصر التحكم بعنصر تحكم آخر في الصفحة. يحدث عند عنصر قائمة هو مرتبط ببيانات.LayoutTemplate

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

نوع القالب

الوصف

LayoutTemplate

The root template that defines a container object, such as a table, div, or span element, that will contain the content defined in the ItemTemplate or GroupTemplate template. و قد يحتوي أيضاً على كائن DataPager.

ItemTemplate

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

ItemSeparatorTemplate

التالية نموذج بيانات مخطط الموقع على سبيل المثال السابق.

GroupTemplate

Defines a container object, such as a table row (tr), div, or span element, that will contain the content defined in the ItemTemplate and EmptyItemTemplate templates. ل GroupItemCountحدث، تمثل هذه معلمة عنصر قائمة بالنقر فوقه بواسطة مستخدم.

GroupSeparatorTemplate

ل الحدث، وتمثل هذه معلمة عنصر قائمة الذي يتم ربط إلى بيانات.

EmptyItemTemplate

استخدم هذا المنشئ لإنشاء مثيل جديد من GroupTemplateفئة من المحدد عنصر قائمة. For example, if the GroupItemCount property is set to 5, and the total number of items returned from the data source is 8, the last group of data displayed by the ListView control will contain three items as specified by the ItemTemplate template, and two items as specified by the EmptyItemTemplate template.

EmptyDataTemplate

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

SelectedItemTemplate

الذي يحتوي على comm و اسم و comm و قيم الوسيطة لعنصر قائمة.

AlternatingItemTemplate

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

EditItemTemplate

المحدد بواسطة معلمة. استخدام EditItemTemplateالخصائص للوصول إلى ItemTemplateالتي مرفوع حدث.

InsertItemTemplate

يحصل على عنصر قائمة المقترنة بحدث مرفوع. The InsertItemTemplate template is rendered in place of an ItemTemplate template at either the start or at the end of the items that are displayed by the ListView control. يمكنك تحديد أين يتم عرض القالب InsertItemTemplate باستخدام خاصية InsertItemPosition لعنصر التحكم ListView.

استخدم ItemTemplateالخصائص للوصول إلى أو تعديل خصائص عنصر قائمة المقترنة بتشغيل حدث. للمزيد من المعلومات حول تعبيرات ربط البيانات، انظر نظرة عامة حول تعبيرات ربط البيانات.

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

سلسلة أحرف تحتوي على اسم خط والحجم لمثيل فئة.

You can bind the ListView control to a data source control (such as SqlDataSource, LinqDataSource, ObjectDataSource, and so on) and to any data source that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, or System.Collections.Hashtable). استخدم إحدى الطريقتين التاليتين إلى يربط ListViewعنصر التحكم إلى بيانات المناسبة لنوع المصدر:

  • إلى يربط إلى عنصر تحكم مصدر بيانات، قم بتعيين DataSourceIDخاصية ListViewعنصر التحكم إلى IDالقيمة في التحكم بمصدر البيانات. تعرض قيم من مصدر بيانات باستخدام معرف من قبل مستخدم قوالب.ListView This هو the preferred أسلوب إلى يربط إلى بيانات.

  • To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the ListView control to the data source, and then call the DataBind method. ربط إلى مصدر بياناتListView عنصر التحكم هو المستخدم ل dهوplay قيم من مصدر بيانات.

لمزيد من المعلومات حول ربط البيانات، راجع الوصول إلى البيانات مع ASP.NET.

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

لما ListViewعنصر تحكم، إلا أنه يعرض بيانات باستخدام القوالب المعرفة من قبل مستخدم بدلاً من حقول الصف. إنشاء قوالب خاصة بك يمنحك مرونة أكثر في التحكم في كيفية بيانات هو dهوplayed. دعم للربط بمصدر بيانات عناصر التحكم مثل ، ، و . المظهر قابلة للتخصيص من خلال معرفة من قبل مستخدم قوالب والأنماط. بناء-في sortفيg إمكانيات. لمزيد من المعلومات، راجع Introduction to the Validation Controls.

العمليات بيانات

When the ListView control is bound to a data source control, the ListView control can take advantage of the data source control's capabilities and provide automatic sort, insert, update, and delete functionality.

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

بناء-في في sert إمكانيات.ListView دعم قدرات الترحيل باستخدام عنصر تحكم.

بناء-في إمكانيات تحديد العنصر.ListView عدة حقول المفاتيح. إلى التعرف على عناصر تحكم غير ذلك ربط البيانات متوفر في ASP.NET، انظر ListView.CommandName من أجل ListViewعنصر تحكم لعرض المحتوى، يجب عليك إنشاء قوالب للأجزاء المختلفة من عنصر تحكم.

الزر

قيمة commandname

الوصف

Cancel

"الغاء الامر"

هو المطلوبة. يقوم برفع حدث ItemCanceling.

حذف

"يحذف"

الأخرى قوالب اختيارية. يرفع ItemDeletedو ItemDeletingالأحداث.

تحديد

خاصية هو غير مطلوب.

Sets the SelectedIndex property to the DisplayIndex property value for the item. على سبيل المثال، على SelectedItemTemplateعنصر تحكم أنه يدعم إدراج السجلات يجب أن يكون تعريف قالب. يرفع SelectedIndexChangingو SelectedIndexChangedالأحداث.

تحرير

"تحرير"

يسرد الجدول التالي القوالب التي تقوم بإنشائها ل عنصر تحكم. على سبيل المثال، على EditItemTemplateعنصر تحكم أنه يدعم إدراج السجلات يجب أن يكون تعريف قالب. يقوم برفع حدث ItemEditing.

إدراج

"إدراج"

قالب الجذر الذي يقوم بتعريف كائن حاوية، مثل كـ على InsertItemTemplate، ، أو عنصر، والتي سوف تحتوي على محتوى المعرفة في أو القالب. يرفع ItemInsertingو ItemInsertedالأحداث.

التحديث

"تحديث"

قم بتعريف محتوى البيانات المرتبطة إلى عرض عناصر الفردية.EditItemTemplate يرفع ItemUpdatingو ItemUpdatedالأحداث.

فرز

قم بتعريف المحتوى إلى تقديم بين عناصر الفردية.

يعرف كائن حاوية، مثل كـ صف جدول ( CommandArgument)، ، أو عنصر، والتي سوف تحتوي على محتوى المعرفة في و القوالب. يرفع Sortingو Sortedالأحداث.

عدد عناصر التي يتم dهوplayed في مجموعة هو المحدد بواسطة ListViewخاصية. قم بتعريف المحتوى إلى تقديم بين مجموعات عناصر.EditItemTemplate قم بتعريف المحتوى إلى تقديم عنصر فارغ عند استخدام قالب. على سبيل المثال، إذا TextBoxتعيين خاصية إلى 5، والعدد الإجمالي للعناصر التي تم إرجاعها من بيانات المصدر هو 8، المجموعة الأخيرة من بيانات التي يتم عرضها بواسطة CheckBoxعنصر التحكم تحتوي على ثلاثة عناصر كما هو محدد القالب وعنصرين كما هو محدد القالب. Defines the محتوى إلى render if the مصدر البيانات إرجاع لا يوجد بيانات.

The insert functionality is enabled when the InsertItemPosition property is set to FirstItem or LastItem. Defines the محتوى إلى render for alternating عناصر إلى make it easier إلى distinguish between consecutive عناصر.InsertItemTemplate Defines the محتوى إلى render when an العنصر هو being تم تحريره. The قالب هو rendered في place of the قالب for the بيانات العنصر that هو being تم تحريره.

الفرز

Defines the محتوى إلى render إلى إدراج an العنصر.ListView The CommandArgument قالب هو rendered في place of an قالب at either the يبدأ أو at the إنهاء of the عناصر that are displayed بواسطة the عنصر تحكم.

ترحيل الصفحات

إلى عرض the القيمة of a حقل في a قالب such كـ ListView, you استخدم a بيانات-ربط تعبير. إلى يربط إدخال عناصر التحكم في the DataPager و ListView قوالب إلى حقول of a بيانات المصدر, you can استخدم الثاني-way يربط expressions. This enables the DataPager عنصر تحكم إلى automatically يفك الضغط the قيم of the إدخال عنصر تحكم for an تحديث أو إدراج تشغيل. LayoutTemplate Alternatively, if the DataPager control is outside the ListView control, set the PagedControlID property to the ID of the ListView control.

أحداث

ففي بعض الأحيان، هو غير عملي بشكل ثابت بتعريف بنية شجرة لأن مصدر البيانات بإرجاع بيانات كثيرة جداً أو أن البيانات dهوplay استناداً إلى المعلومات التي تحصل عليها في وقت التشغيل.ListView

الحدث

الوصف

ItemCanceling

لمزيد من المعلومات حول التعبيرات ربط ثنائي الاتجاه، راجع CommandName.ListView يمكنك يربط عنصر التحكم إلى عنصر تحكم مصدر بيانات (مثل كـ ، ، ، وهكذا) وعلى أي مصدر بيانات يقوم بتطبيق واجهة (مثل كـ ، ، أو ).

ItemCommand

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

ItemCreated

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

ItemDataBound

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

ItemDeleted

Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, after the ListView control deletes the record from the data source. Th هو حدث هو غالباً للتحقق من نتائج عملية الحذف.

ItemDeleting

Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked or the DeleteItem method is called, but before the ListView control deletes the record from the data source. يوفر ASP.NET على ميزة التحقق من صحة إدخال طلب إلى المساعدة في حظر برنامج نصي و HTML في إدخال مستخدم.

ItemEditing

Occurs when an Edit button (a button with its CommandName property set to "Edit") is clicked, but before the ListView control enters edit mode. عند عنصر التحكم هو مرتبط بعنصر تحكم مصدر بيانات، التحكم يمكن الاستفادة من مصدر البيانات القدرات الخاصة بعنصر التحكم وتوفير فرز تلقائي، إدراج وتحديثها، وحذفها وظيفة.

ItemInserted

Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, after the ListView control inserts the new record from the data source. Th هو حدث هو غالباً للتحقق من نتائج عملية الإدراج.

ItemInserting

Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked or the InsertNewItem method is called, but before the ListView control inserts the record. لأن عنصر تحكم تستخدم القوالب، فإنه لا توفر طريقة لإنشاء الأزرار لإجراء تحديث، والحذف، والإدراج، وفرز تلقائياً، أو حدد العمليات.

ItemUpdated

Occurs when an Update button (a button with its CommandName property set to "Update") is clicked or the UpdateItem method is called, after the ListView control updates the record. This حدث هو often used إلى فحص the نتائج of the تحديث تشغيل.

ItemUpdating

CommandName عنصر تحكم يتعرف على بعض الأزرار الذين UpdateItemخاصية هو معينة إلى القيمة معينة.ListView يسرد الجدول التالي الأزرار التي عنصر تحكم يتعرف عليها والدالات بها.

LayoutCreated

Occurs when the LayoutTemplate template is created in a ListView control. قم بحذف الحالي سجل من مصدر بيانات.

PagePropertiesChanged

"تحديد"ListView

PagePropertiesChanging

بتعيين ListViewخاصية إلى القيمة خاصية لعنصر.

SelectedIndexChanged

يعرض CommandNameقالب العنصر.ListView يضع العنصر في تحرير الوضع.

SelectedIndexChanging

قم بإدراج قيم منضم من CommandNameقالب إلى بيانات المصدر.ListView قم بتحديث الحالي سجل في مصدر بيانات بقيم منضم من القالب.

Sorted

Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, after the ListView control handles the sort operation. فرز أعمدة المسرودة في خاصية زر.

Sorting

Occurs when a Sort button (a button with its CommandName property set to "Sort") is clicked or the Sort method is called, but before the ListView control handles the sort operation. في الوضع التحرير، والمحتوى الذي هو في خاصية هو dهوplayed للحالي بيانات العنصر.

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

<asp:ListView
    ConvertEmptyStringToNull="True|False"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    GroupPlaceholderID="string"
    GroupItemCount="integer"
    ID="string"
    InsertItemPosition="None|FirstItem|LastItem"
    ItemPlaceholderID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCanceling="ItemCanceling event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemEditing="ItemEditing event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLayoutCreated="LayoutCreated event handler"
    OnLoad="Load event handler"
    OnPagePropertiesChanged="PagePropertiesChanged event handler"
    OnPagePropertiesChanging="PagePropertiesChanging event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    runat="server"
    SelectedIndex="integer"
    SkinID="string"
    Style="string"
    Visible="True|False"
>
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <EmptyItemTemplate>
            <!-- child controls -->
        </EmptyItemTemplate>
        <GroupSeparatorTemplate>
            <!-- child controls -->
        </GroupSeparatorTemplate>
        <GroupTemplate>
            <!-- child controls -->
        </GroupTemplate>
        <InsertItemTemplate>
            <!-- child controls -->
        </InsertItemTemplate>
        <ItemSeparatorTemplate>
            <!-- child controls -->
        </ItemSeparatorTemplate>
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <LayoutTemplate>
                <!-- child controls -->
        </LayoutTemplate>
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
</asp:ListView>

بشكل عام، في قالب العنصر تحرير، الزر تحرير هو استبدالها بتحديث زر "إلغاء الأمر".ListView إدخال عناصر التحكم المناسبة لنوع بيانات الحقل (على سبيل المثال على LinqDataSourceأو عنصر التحكم) أيضا عادة عرض القيمة حقل لمستخدم بتعديل.


<%@ Page language="C#" %>

<!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" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <asp:ListView ID="VendorsListView"
        DataSourceID="VendorsDataSource"
        DataKeyNames="VendorID"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" width="640px" border="1" ID="tbl1" runat="server">
            <tr runat="server" style="background-color: #98FB98">
              <th runat="server">ID</th>
              <th runat="server">Account Number</th>
              <th runat="server">Name</th>
              <th runat="server">Preferred Vendor</th>
            </tr>
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager ID="DataPager1" runat="server">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label ID="VendorIDLabel" runat="server" Text='<%# Eval("VendorID") %>' />
            </td>
            <td>
              <asp:Label ID="AccountNumberLabel" runat="server" Text='<%# Eval("AccountNumber") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%# Eval("Name") %>' /></td>
            <td>
              <asp:CheckBox ID="PreferredCheckBox" runat="server" 
                Checked='<%# Eval("PreferredVendorStatus") %>' Enabled="False" />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects   -->
      <!-- to the AdventureWorks sample database. Add a LINQ     -->
      <!-- to SQL class to the project to map to a table in      -->
      <!-- the database.                                         -->
      <asp:LinqDataSource ID="VendorsDataSource" runat="server" 
        ContextTypeName="AdventureWorksClassesDataContext" 
        Select="new (VendorID, AccountNumber, Name, PreferredVendorStatus)" 
        TableName="Vendors" Where="ActiveFlag == @ActiveFlag">
        <WhereParameters>
          <asp:Parameter DefaultValue="true" Name="ActiveFlag" Type="Boolean" />
        </WhereParameters>
      </asp:LinqDataSource>

    </form>
  </body>
</html>


The following example shows how to use the ListView control to display values in a flow layout by using the div element. إدخال عناصر التحكم المناسبة لنوع بيانات الحقل (على سبيل المثال على SqlDataSourceأو عنصر التحكم) أيضا عادة عرض القيمة حقل لمستخدم بتعديل.


<%@ Page language="C#" %>

<!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" >
  <head id="Head1" runat="server">
    <title>ListView Flow Layout Example</title>
    <style type="text/css">
      .plainBox {
          font-family: Verdana, Arial, sans-serif;
          font-size: 11px;
          background: #ffffff;
          border:1px solid #336666;
          }
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Flow Layout Example</h3>

      Select the color:
      <asp:DropDownList ID="ColorList" runat="server" 
        AutoPostBack="True" 
        DataSourceID="ColorDataSource" 
        DataTextField="Color" 
        DataValueField="Color">
      </asp:DropDownList><br /><br />

      <asp:ListView runat="server" ID="ProductListView"
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID">
        <LayoutTemplate>
          <div runat="server" id="lstProducts">
            <div runat="server" id="itemPlaceholder" />
          </div>
          <asp:DataPager runat="server" PageSize="5" >
            <Fields>
              <asp:NextPreviousPagerField 
                ButtonType="Button"
                ShowFirstPageButton="True" 
                ShowLastPageButton="True" />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <asp:Image ID="ProductImage" runat="server"
            ImageUrl='<%# "~/images/thumbnails/" + Eval("ThumbnailPhotoFileName") %>' />	        
          <div class="plainBox" runat="server">
            <asp:HyperLink ID="ProductLink" runat="server" Text='<%# Eval("Name") %>' 
              NavigateUrl='<%# "ProductDetails.aspx?productID=" + Eval("ProductID") %>' />
            <br /><br />
            <b>Price:</b> 
            <asp:Label ID="PriceLabel" runat="server" Text='<%# Eval("ListPrice", "{0:c}")%>' /> <br />
          </div>
          <br />
        </ItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->
      <asp:SqlDataSource ID="ProductsDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"            	        
        SelectCommand="SELECT P.ProductID, P.Name, P.Color, P.ListPrice, 
          PF.ThumbnailPhotoFileName, P.Size
          FROM Production.Product AS P 
          INNER JOIN Production.ProductProductPhoto AS PPF ON P.ProductID = PPF.ProductID 
          INNER JOIN Production.ProductPhoto AS PF ON PPF.ProductPhotoID = PF.ProductPhotoID
          WHERE P.Color = @Color" >
        <SelectParameters>
          <asp:ControlParameter ControlID="ColorList" Name="Color" 
            PropertyName="SelectedValue" />
        </SelectParameters>
      </asp:SqlDataSource>

      <asp:SqlDataSource ID="ColorDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>" 
        SelectCommand="SELECT DISTINCT Color FROM Production.Product">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


The إدراج functionality هو ممكّن when the ListView خاصية هو التعيين إلى أو .

ملاحظة الأمانملاحظة الأمان

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


<%@ Page language="C#" %>

<!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" >
  <head id="Head1" runat="server">
    <title>ListView Example</title>
    <style type="text/css">
        .EditItem { background-color:#8FBC8F;}
        .SelectedItem {	background-color:#9ACD32; }
        .InsertItem { background-color:#FFFACD;}
    </style>
  </head>
  <body>
    <form id="form1" runat="server">

      <h3>ListView Example</h3>

      <h5>Departments</h5>

      <asp:ListView ID="DepartmentsListView" 
        DataSourceID="DepartmentsDataSource" 
        DataKeyNames="DepartmentID"
        ConvertEmptyStringToNull="true"
        InsertItemPosition="LastItem"
        runat="server">
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblDepartments" width="640px" cellspacing="0">
            <tr runat="server" id="itemPlaceholder" />
          </table>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Button ID="SelectButton" runat="server" Text="Select" CommandName="Select" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <SelectedItemTemplate>
          <tr class="SelectedItem" runat="server">
            <td>
              <asp:Button ID="DeleteButton" runat="server" Text="Delete" CommandName="Delete" />
              <asp:Button ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
            </td>
            <td>
              <asp:Label ID="GroupNameLabel" runat="server" Text='<%#Eval("GroupName") %>' />
            </td>
          </tr>
        </SelectedItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:Button ID="UpdateButton" runat="server" CommandName="Update" Text="Update" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <b>ID</b><br />
              <asp:Label ID="IDLabel" runat="server" Text='<%#Eval("DepartmentID") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />
              <asp:TextBox ID="GroupNameTextBox" runat="server" 
                Width="200px"
                Text='<%#Bind("GroupName") %>' />
              <br />
            </td>
          </tr>
        </EditItemTemplate>
        <InsertItemTemplate>
          <tr class="InsertItem">
            <td colspan="2">
              <asp:Button ID="InsertButton" runat="server" CommandName="Insert" Text="Insert" />
              <asp:Button ID="CancelButton" runat="server" CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="NameLabel" AssociatedControlID="NameTextBox" 
                Text="Name" Font-Bold="true"/><br />
              <asp:TextBox ID="NameTextBox" runat="server" Text='<%#Bind("Name") %>' /><br />
            </td>
            <td>
              <asp:Label runat="server" ID="GroupNameLabel" AssociatedControlID="GroupNameTextBox" 
                Text="Group Name" Font-Bold="true" /><br />                
              <asp:TextBox ID="GroupNameTextBox" runat="server" Text='<%#Bind("GroupName") %>' />
            </td>
          </tr>
        </InsertItemTemplate>
      </asp:ListView>

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->            
      <asp:SqlDataSource ID="DepartmentsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT DepartmentID, Name, GroupName FROM HumanResources.Department"
            UpdateCommand="UPDATE HumanResources.Department 
                SET Name = @Name, GroupName = @GroupName WHERE (DepartmentID = @DepartmentID)"            
	        DeleteCommand="DELETE FROM HumanResources.Department 
	            WHERE (DepartmentID = @DepartmentID)" 
	        InsertCommand="INSERT INTO HumanResources.Department(Name, GroupName) 
	            VALUES (@Name, @GroupName)">
      </asp:SqlDataSource>

    </form>
  </body>
</html>


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

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

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

.NET Framework

مدعوم في: 4, 3.5
إظهار: