هذه المقالة مترجمة آليًا. حرك المؤشر فوق الجمل في المقالة لعرض النص الأصلي. المزيد من المعلومات.

الترجمة

الأصلي

لم يتم تصنيف هذا الموضوع بعد - تصنيف هذا الموضوع

GridView الفئة

.NET Framework 4

يوضح المثال التالي طريقة لمعالجة حدث الخاص عنصر تحكم. يرفع GridViewحدث وينفذ غير ذلك التهيئة.

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

بناء الجملة

C++

[ControlValuePropertyAttribute("SelectedValue")]
public class GridView : CompositeDataBoundControl, IPostBackContainer, 
	IPostBackEventHandler, ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IDataKeysControl, 
	IDataBoundListControl, IDataBoundControl, IFieldControl

ASP.NET

<asp:GridView />

ملاحظات

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

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

مقدمة

في ترتيب هو مرحلة في دورة حياة الصفحة، وعناصر تحكم الخادم في هيكلي لتاريخ الإنشاء وتهيئة، وعرض الولاية هو استعادة، وعناصر تحكم النماذج يعكس بيانات من جانب العميل.GridView كائن يحتوي على بيانات حدث. يدعم عنصر التحكم GridView الميزات التالية:

يمكن استخدامها مع SqlDataSourceعنصر التحكم، عنصر تحكم، أو باستخدام المصادر بيانات التابعة.
الحدث هو المستخدم لإجراء أية تحديثات قبل الإخراج لعنصر تحكم ملقم هو عرض على الصفحة.
يوضح المثال التالي كيفية استخدام خاصية لتحديد خط مسطر بطريقة برمجية عنصر تحكم.
بناء-في pagفيg إمكانيات.
التغييرات في الولاية عرض الملقم عنصر تحكم يمكن تم الحفظها أثناء هذا حدث.
الوصول المبرمج إلى GridViewطراز الكائن شكل حيوي بتعيين الخصائص، والأحداث hوle، و. هكذا
أسلوب هو المستخدمة لتعيين الجميع خصائص unset لالولاية وقم بإزالة أية إدخالات في الولاية العرض.
لا يتم تم الحفظ تلك التغييرات التي أجريت في مرحلة رسم هندسي.
عنصر تحكم يسمح لك سلاسل بحث وبحث عن قيم رقمية في نطاق معين ومقارنة القيمة خاصية في جدول إلى القيمة محددة.
الحصول على أو قم بتعيين القيمة للإشارة إلى ما إذا كان نظرة عامة عناصر تحكم ملقم ويب ربط البيانات ASP.NETعنصر تحكم بحاجة إلى يربط مصدر بيانات المحدد الخاص به.

ملاحظة
DataGrid إذاGridViewعنصر تحكم بحاجة إلى يربط مصدر بيانات؛ وإلا،DataGrid.

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

GridView عنصر تحكم يستخدم DataControlFieldخاصية لتحديد ما إذا كان عنصر تحكم بحاجة للاتصال أسلوب الربط بمصدر بيانات المحدد الخاص به. كل مرة تقوم أسلوب استرجاع قيمة التعيين هو يطلق تشغيل أي من AutoGenerateColumns، true، أو AutoGeneratedFieldخاصية لتغيير مصدر بيانات بعد لقد تم استدعاء الأسلوب، يقوم ASP.NET بتعيين القيمة الخاصية إلى . القيمة GridViewخاصية هو أيضا بتعيين إلى عند أسلوب هو تسمى.

يقوم ASP.NET بتعيين القيمة GridViewخاصية إلى AutoGenerateColumnsمباشرة بعد falseأسلوب هو تسمى. الحصول أو تعيين واجهة تعرف كيفية الفاصل بين عناصر هو dهوplayed. التي تعرف كيفية الفاصل بين عناصر هو dهوplayed.

للحصول على معلومات حول كيفية استخدام هذا خيار لعامل التصفية، راجع .	الوصف
BoundField	استخدام خاصية لإنشاء قالب يتحكم في كيفية الفاصل بين عناصر هو dهوplayed. يمكنك استخدام GridViewخاصية إلى عرض إدخال مستخدم، والتي قد تضمين العميل الضارة برنامج نصي.
ButtonField	يوضح المثال تعليمات برمجية التالي كيفية إنشاء قالب ل عنصر تحكم طريقة عرض فواصل بين عناصر.GridView الحصول أو تعيين القيمة تشير إلى ما إذا كان يتم تطبيق السمات على هذا عنصر تحكم.
CheckBoxField	GridView خاصية تشير إلى ما إذا كان يتم ممكّن السمات. عند هو خاصية ، الدليل السمة الخاص بتطبيق هو البحث عن عنصر تحكم الأسطح لتطبيق.
CommandField	في حالة عدم وجود سطح المعينة عنصر تحكم موجوداً في الالدليل سمة أسطح خارجية لم يتم تطبيقها.
HyperLinkField	Determines whether a value هو greater than or less than a specified value, or whether a value هو between two values. إرجاع الالقيمة للإشارة إلى ما إذا كان عنصر تحكم تمت تهيئة.
ImageField	GridView ، إذا كان عنصر تحكم تمت تهيئة، وإلا،.
TemplateField	GridView الخاصية هو خاصية مساعد التي هو المستخدمة لتحديد ما إذا كان ربط بيانات هو مطلوبة عند ، ، أو الخاصية هو تم تغييره. الحصول القيمة تشير إلى ما إذا كان خاصية هو. التعيين

<Columns> إذاGridViewخاصية هو تعيين إلى القيمة مختلفة عن سلسلة أحرف فارغ ("")؛ otherwهوe،. <Columns> الخاصية هو خاصية مساعد الذي يحدد ما إذا كان عنصر التحكم هو مرتبط بعنصر تحكم مصدر بيانات ASP.NET 2.0، مثل أو عنصر التحكم. تحصل على Columnsالكائنات التي عنصر تحكم يستخدم عند يتم الآن استرداد البيانات? من مصدر بيانات عنصر تحكم. Columns استخدام كائن استرداد بيانات.GridView

الاستدعاء أول إلى كائن المكالمات أسلوب لإنشاء الكائن. الاستدعاء أول إلى خاصية المكالمات أسلوب للعودة القيمة.

ملاحظة
إرجاع Columnsواجهة من بيانات المصدر.

ربط بيانات إلى

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

إلى يربط إلى عنصر تحكم مصدر بيانات، قم بتعيين DataSourceIDخاصية GridViewعنصر التحكم إلى IDالقيمة في التحكم بمصدر البيانات. بيانات المصدر هو محدد بواسطة GridViewخاصية أو حسب و الخصائص. This هو the preferred أسلوب إلى يربط إلى بيانات.
إلى يربط إلى a بيانات المصدر that implements the System.Collections.IEnumerable واجهة, programmatically التعيين the DataSource خاصية of the GridView عنصر تحكم إلى the بيانات المصدر و then يتصل the DataBind أسلوب. يحدد ما إذا كان ربط بيانات هو المطلوبة.GridView You need إلى provide this functionality بواسطة using the appropriate حدث.

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

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

ملاحظة

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

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

GridView الأسلوب هو أسلوب مساعد يسمى عند ، ، أو يتم تم تغييره خاصية. قم بتعيين GridViewخاصية إلى GridView.

ملاحظة
GridView الأسلوب هو أسلوب مساعد الذي يشترك في بيانات بربط عملية. يتم استدعاء هذا الأسلوب عند الكائن raises عنصر تحكم مصدر بيانات المقترن به حدث.

يتسبب في حدوث حدث GridViewعنصر تحكم لربط بيانات ببيانات المحدثة. To enable sorting, set the AllowSorting property to true.

ButtonField عنصر تحكم تمكنك من تحديد وفرز وتحرير هذه عناصر.TemplateField The GridView control can automatically add a CommandField column field with an Edit, Delete, or Select button if the AutoGenerateEditButton, AutoGenerateDeleteButton, or AutoGenerateSelectButton property is set to true, respectively.

ملاحظة
GridView عنصر التحكم هو المستخدم dهوplay قيم من مصدر بيانات في جدول. However, it is possible to insert records by using the GridView control in conjunction with the DetailsView or FormView control. For more information, see DetailsView or FormView, respectively.

بناء-في إمكانيات تحديد صف.GridView لتمكين ترحيل الصفحات، قم بتعيين AllowPagingخاصية إلى true.

ملاحظة
The GridView control is re-created on postback based on the information that is stored in ViewState. If the GridView control includes a TemplateField or a CommandField with the CausesValidation property set to true, then the EnableViewState property must also be set to true to ensure that concurrent data operations, such as updates and deletes, apply to the appropriate row.

تخصيص واجهة مستخدم

يمكنك يخصص الالمظهر GridViewعنصر تحكم بتعيين خصائص الالنمط أجزاء مختلفة عنصر تحكم. يسرد الجدول التالي خصائص النمط آخر.

خاصية نمط	الوصف
AlternatingRowStyle	Each بيانات صف في the GridView عنصر تحكم هو تاريخ الإنشاء بواسطة declaring a حقل عنصر تحكم. When this property is set, the data rows are displayed alternating between the RowStyle settings and the AlternatingRowStyle settings.
EditRowStyle	إذا كنت على معرفة مع GridViewعنصر تحكم من برنامج.NET Framework الإصدار 1.0، عنصر تحكم هو اللاحقة عنصر تحكم.
EmptyDataRowStyle	إعدادات النمط لصف بيانات الفارغ في GridViewعنصر تحكم عند مصدر بيانات لا يحتوي على أية سجلات.
FooterStyle	إعدادات النمط لصف التذييل في GridViewعنصر التحكم.
HeaderStyle	إعدادات النمط لصف رأس GridViewعنصر تحكم.
PagerStyle	كل عمود في GridViewعنصر التحكم هو يمثله الكائن.
RowStyle	Thهو حقل صف type هو commonly used to dهوplay حقول مع a منطقي القيمة.GridView When the AlternatingRowStyle property is also set, the data rows are displayed alternating between the RowStyle settings and the AlternatingRowStyle settings.
SelectedRowStyle	بشكل افتراضي، GridViewخاصية هو تعيين إلى ، الذي يقوم بإنشاء الكائن لكل حقل في مصدر بيانات.
SortedAscendingCellStyle	كل حقل هو ثم تقديم كعمود في GridViewالتحكم بالترتيب الذي يظهر كل حقل في مصدر بيانات. يمكنك أيضا يدوياً عنصر تحكم التي تظهر حقول الأعمدة في عنصر تحكم بتعيين خاصية إلى وثم تعريف الخاص بك مجموعة حقل عمود.
SortedAscendingHeaderStyle	كل حقل هو ثم تقديم كعمود في GridViewالتحكم بالترتيب الذي يظهر كل حقل في مصدر بيانات. تحدد أنواع حقل عمود آخر سلوك أعمدة الموجودة في عنصر تحكم.GridView
SortedDescendingCellStyle	كل حقل هو ثم تقديم كعمود في GridViewالتحكم بالترتيب الذي يظهر كل حقل في مصدر بيانات. يسرد الجدول التالي المختلفة حقل عمود الأنواع التي يمكن استخدامها.
SortedDescendingHeaderStyle	كل حقل هو ثم تقديم كعمود في GridViewالتحكم بالترتيب الذي يظهر كل حقل في مصدر بيانات. يعرض القيمة حقل في بيانات المصدر.GridView

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

الخصائص	الوصف
ShowFooter	تطبيق كائن GridViewالذي يمكن أن يكون منضماً إلى بيانات المصدر.
ShowHeader	يحصل العرض المقترنة بمصدر بيانات لمصدر بيانات المسمى عنصر تحكم.GridView

أحداث

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

الحدث	الوصف
PageIndexChanged	Occurs when واحد of the pager الأزرار هو clicked, but بعد the GridView عنصر تحكم handles the ترحيل تشغيل. يعرض زر أمر لكل عنصر في عنصر تحكم.
PageIndexChanging	Occurs when واحد of the pager الأزرار هو clicked, but قبل the GridView عنصر تحكم handles the ترحيل تشغيل. This حدث هو often used إلى إلغاء الأمر the ترحيل تشغيل.
RowCancelingEdit	وهذا يتيح لك إلى إنشاء عمود cusإلىm butإلىn، مثل إضافة أو butإلىn إزالة.GridView يعرض صندوق الاختيار لكل عنصر في عنصر تحكم.
RowCommand	يحدث عند النقر فوق زر في عنصر تحكم GridView . غالباً ما يتم استخدام هذا الحدث لتنفيذ مهمة عند النقر فوق زر في عنصر تحكم.
RowCreated	يحدث عند إنشاء صف جديد في عنصر تحكم GridView . عادة ما يتم استخدام نوع الحقل هذا العمود إلى عرض حقول التي تحتوي على القيمة منطقية.
RowDataBound	عرض معرف مسبقاً butإلىns الأمر إلى إجراء، حدد تحرير العمليات أو حذفها.GridView وهذا عمود نوع حقل يتيح لك يربط حقل ثاني إلى محدد موقع معلومات رابط.
RowDeleted	قم بعرض نسخة لكل عنصر في GridViewعنصر تحكم. Th هو حدث هو غالباً للتحقق من نتائج عملية الحذف.
RowDeleting	قم بعرض محتوى المعرفة من قبل مستخدم لكل عنصر في GridViewعنصر تحكم استناداً إلى القالب المحدد. نوع الحقل هذا العمود يتيح لك إلى إنشاء حقل عمود cusإلىm.
RowEditing	لتعريف مجموعة حقل عمود بشكل إلزامي، أول إضافة فتح وإغلاق GridViewعلامات بين الفتح والإغلاق علامات من عنصر التحكم. عند عنصر التحكم هو مرتبط بعنصر تحكم مصدر بيانات، التحكم يمكن الاستفادة من مصدر البيانات القدرات الخاصة بعنصر التحكم وتوفير فرز تلقائي، إدراج وتحديثها، وحذفها وظيفة.
RowUpdated	بعد ذلك قائمة حقول الأعمدة التي تريدها إلى تتضمن بين فتح وإغلاق GridViewعلامات. This حدث هو often used إلى فحص the نتائج of the تحديث تشغيل.
RowUpdating	تتم تمت الإضافة أعمدة المحددة إلى GridViewمجموعة بالترتيب سردها. مجموعة تخزين الجميع حقول الأعمدة في عنصر تحكم وتمكنك من إدارة حقول العمود برمجياً عنصر تحكم.
SelectedIndexChanged	التصريح بوضوح عمود يمكن أن يتم عرض الحقول في تركيبة مع يتم إنشاؤه تلقائياً عمود الحقول.GridView عند استخدام كليهما، حقول الأعمدة المعلن بوضوح يتم تقديمها أولاً، متبوعة بحقول الأعمدة التي تم إنشاؤها تلقائياً.
SelectedIndexChanging	تلقائياً بإنشاء عمود لا تتم تمت الإضافة حقول إلى GridViewمجموعة. يمكن أن يكون عنصر التحكم منضماً إلى بيانات المصدر عنصر التحكم (مثل ، ، وهكذا)، كما يحذف كاي البيانات المصدر الذي يطبق واجهة (مثل ، ، أو ).
Sorted	GridView عنصر التحكم تلقائياً بربط بيانات المحددة المصدر التحكم ويمكن الاستفادة من بيانات المصدر قدرات عنصر تحكم للقيام بالفرز، جاري الآن التحديث، وحذف، وترحيل. When using this أسلوب, the عنصر تحكم does not provide built-في فرز, تحديث, يحذف, و ترحيل functionality.
Sorting	Whenever possible, it هو strongly recommended that قيم are HTML-encoded قبل they are displayed في this عنصر تحكم (the GridView فئة HTML-encodes قيم بواسطة الافتراضي). في الوضع التحرير، والمحتوى الذي هو في خاصية هو dهوplayed للحالي بيانات العنصر.

‏إمكانية وصول ذوي الاحتياجات الخاصة

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

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

<asp:GridView
    AccessKey="string"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateSelectButton="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    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"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    EmptyDataText="string"
    Enabled="True|False"
    EnableSortingAndPagingCallbacks="True|False"
    EnableTheming="True|False"
    EnableViewState="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"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnRowCancelingEdit="RowCancelingEdit event handler"
    OnRowCommand="RowCommand event handler"
    OnRowCreated="RowCreated event handler"
    OnRowDataBound="RowDataBound event handler"
    OnRowDeleted="RowDeleted event handler"
    OnRowDeleting="RowDeleting event handler"
    OnRowEditing="RowEditing event handler"
    OnRowUpdated="RowUpdated event handler"
    OnRowUpdating="RowUpdating event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
        NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    PageSize="integer"
    RowHeaderColumn="string"
    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"
>
        <AlternatingRowStyle />
        <Columns>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Columns>
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FooterStyle />
        <HeaderStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle />
        <SelectedRowStyle />
</asp:GridView>

Topic	Location
كيفية القيام بما يلي: تمكين الحذف الافتراضي في عنصر تحكم خادم الويب GridView	dv_vwdcon
الإرشادات التفصيلية: فرز بسيط لعنصر تحكم خادم الويب GridView	dv_vwdcon
الإرشادات التفصيلية: صفحات ويب ربط البيانات مع مكون بيانات ‏‫Visual Studio	dv_vwdcon
الإرشادات التفصيلية: تحرير و إدراج البيانات في صفحات الويب مع عنصر تحكم خادم الويب DetailsView	dv_vwdcon
كيفية القيام بما يلي: تخصيص عناصر التحكم للتحرير في GridView عنصر تحكم الخادم الويب	dv_vwdcon
الإرشادات التفصيلية: إنشاء واستخدام الصفحات ASP.NET الرئيسية في ‏‫Visual Web Developer	dv_vwdcon
كيفية القيام بما يلي: قم بإنشاء قوالب عنصر تحكم ويب ASP.NET بشكل إلزامي	dv_vwdcon
كيفية القيام بما يلي: يعيّن بقاعدة بيانات الوصول باستخدام عنصر التحكم الموجود في AccessDataSource	dv_vwdcon
كيفية القيام بما يلي: الاستجابة إلى Butإلىn الأحداث في عنصر تحكم عرض الشبكة	dv_vwdcon
الإرشادات التفصيلية: الوصول إلى بيانات أساسية في صفحات الويب	dv_vwdcon
كيفية القيام بما يلي: تمكين تحديد الافتراضي في عرض الشبكة عنصر تحكم خادم ويب	dv_vwdcon
كيفية القيام بما يلي: إنشاء قوالب عناصر تحكم خادم الويب بإستخدام المصمم	dv_vwdcon
كيفية القيام بما يلي: إنشاء قوالب عنصر تحكم خادم ويب ASP.NET ديناميكياً	dv_vwdcon
كيفية القيام بما يلي: تعيين عرض عمود تحكم خادم الويب GridView بشكل حيوي	dv_vwdcon
الإرشادات التفصيلية: إنشاء صفحة ويب لعرض بيانات XML	dv_vwdcon
كيفية القيام بما يلي: الربط إلى بيانات موجودة في عنصر تحكم قالب	dv_vwdcon
الإرشادات التفصيلية: ربط بيانات إلى كائن أعمال مخصص	dv_vwdcon
الإرشادات التفصيلية: إنشاء صفحة ويب لعرض بيانات قاعدة بيانات الوصول	dv_vwdcon
الإرشادات التفصيلية: عرض قائمة منسدلة إلى أسفل أثناء التحرير في عنصر تحكم خادم الويب GridView	dv_vwdcon
الإرشادات التفصيلية: تنفيذ تحديثات مجمع إلى صفوف منضمة تحكم خادم ويب GridView	dv_vwdcon
الإرشادات التفصيلية: عرض بيانات باستخدام إجراء المخزّن في عنصر تحكم خادم الويب GridView	dv_vwdcon
كيفية القيام بما يلي: تمكين الافتراضي ‏‏تحرير في the عرض الشبكة ويب عنصر تحكم الخادم	dv_vwdcon
كيفية القيام بما يلي: تمكين التنقل الافتراضي بين الصفحات في عنصر تحكم خادم الويب GridView	dv_vwdcon
كيفية القيام بما يلي: الربط بالبيانات في عنصر التحكم في القالب في ‏‫Visual Studio	dv_vwdcon
الإرشادات التفصيلية: إنشاء صفحات ويب رئيسية/تفصيلية في ‏‫Visual Studio	dv_vwdcon
الإرشادات التفصيلية: إنشاء عنصر تحكم GridView متداخل	dv_vwdcon
كيفية القيام بما يلي: الاستجابة إلى Butإلىn الأحداث في قائمة بيانات أو عناصر إعادة تقوية	dv_vwdcon
الإرشادات التفصيلية: عرض مستند XML في نماذج ويب الصفحة استخدام تحويلات	dv_vwdcon

أمثلة

The GridView عنصر تحكم provides many built-في capabilities that allow the مستخدم إلى فرز, تحديث, يحذف, تحديد, و الصفحة through عناصر في the عنصر تحكم. When the SqlDataSource عنصر تحكم هو حدود إلى a بيانات التحكم بالمصادر, the عنصر تحكم can يستفيد of the بيانات التحكم بالمصادر's capabilities و provide تلقائي فرز, تحديث, و يحذف functionality.



<%@ 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 runat="server">
    <title>GridView Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>GridView Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">                
      </asp:gridview>

      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>

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

The GridView عنصر تحكم can provide دعم for فرز, جاري الآن التحديث, و deleting مع غير ذلك أنواع of بيانات المصادر.



<%@ 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 runat="server">
    <title>GridView Edit Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <h3>GridView Edit Example</h3>
    <asp:LinqDataSource ID="LinqDataSource1" runat="server" 
        ContextTypeName="AdventureWorksLTDataClassesDataContext"
        EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
        TableName="SalesOrderDetails">
    </asp:LinqDataSource>
    <asp:GridView ID="GridView1" runat="server" 
        AutoGenerateColumns="False" 
        DataKeyNames="SalesOrderID,SalesOrderDetailID"
        DataSourceID="LinqDataSource1">
        <Columns>
            <asp:CommandField ShowDeleteButton="True" 
                ShowEditButton="True" />
            <asp:BoundField DataField="SalesOrderID" 
                HeaderText="SalesOrderID" ReadOnly="True"
                SortExpression="SalesOrderID" />
            <asp:BoundField DataField="SalesOrderDetailID" 
                HeaderText="SalesOrderDetailID" InsertVisible="False"
                ReadOnly="True" SortExpression="SalesOrderDetailID" />
            <asp:BoundField DataField="OrderQty" 
                HeaderText="OrderQty" SortExpression="OrderQty" />
            <asp:BoundField DataField="ProductID" 
                HeaderText="ProductID" SortExpression="ProductID" />
            <asp:BoundField DataField="UnitPrice" 
                HeaderText="UnitPrice" SortExpression="UnitPrice" />
            <asp:BoundField DataField="ModifiedDate" 
                HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
        </Columns>
    </asp:GridView>
    </form>
</body>
</html>

However, you will need إلى provide an appropriate معالج الأحداث مع the implementation for these العمليات.GridViewRow

التسلسل الهيكلي للإرث

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.CompositeDataBoundControl
            System.Web.UI.WebControls.GridView

أمان العملية الجزئية

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في 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

راجع أيضًَا

محفوظات التغيير

التاريخ	المحفوظات	السبب
يوليو 2008	Sorting allows the مستخدم إلى فرز the عناصر في the عنصر تحكم مع respect إلى a specific عمود بواسطة clicking تشغيل the عمود's عنوان. ColumnsGenerator property, EnableModelValidation property, SelectedPersistedDataKey property, IPersistedSelector.DataKey property.	تغيير ميزة حزمة الخدمة SP1.

التاريخ

المحفوظات

السبب

يوليو 2008

Sorting allows the مستخدم إلى فرز the عناصر في the عنصر تحكم مع respect إلى a specific عمود بواسطة clicking تشغيل the عمود's عنوان. ColumnsGenerator property, EnableModelValidation property, SelectedPersistedDataKey property, IPersistedSelector.DataKey property.

تغيير ميزة حزمة الخدمة SP1.

هل وجدت هذا المحتوى مفيدًا؟ نعم لا

غير دقيق

ليس عميقًا بما يكفي

الحاجة لمزيد من أمثلة التعليمات البرمجية

يلزم تحسين هذه الترجمة

(1500 الأحرف المتبقية)

إضافات المجتمع

إضافة