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.

GridViewRow الفئة

Visual Studio 2010

يمثل صف فردي في عنصر التحكم GridView .

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

public class GridViewRow : TableRow, 
	IDataItemContainer, INamingContainer
<asp:GridViewRow />

The GridViewRow class is used represent an individual row in a GridView control. كل صف في GridViewعنصر تحكم على نوع معين من الصفوف. يسرد الجدول التالي المختلفة صف أنواع.

نوع الصف

الوصف

DataControlRowType.DataRow

إذا GridViewالخاصية هو فارغ، عنصر التحكم هو لم يتم تقديم.

DataControlRowType.EmptyDataRow

GridView الذي يحتوي على قاموس من زوج الاسم/القيمه الحقل الأصلي للسجل إلى التحديث. The empty row is displayed when the GridView control has no records to display and the GridView.EmptyDataTemplate template is not null.

DataControlRowType.Footer

صف التذييل في GridViewعنصر تحكم.

DataControlRowType.Header

صف الرأس في GridViewعنصر تحكم.

DataControlRowType.Pager

صف نداء في GridViewعنصر التحكم.

DataControlRowType.Separator

صف فاصل في GridViewعنصر تحكم.

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

الولاية القيمة

الوصف

DataControlRowState.Alternate

لتغيير نص المعروض بواسطة GridViewRowعنصر تحكم، قم بتعيين GridViewخاصية.

DataControlRowState.Edit

GridViewRow الكائن هو في تحرير الوضع.

DataControlRowState.Normal

GridViewRow الكائن هو في الولاية عادي (افتراضي) الخاص به.

DataControlRowState.Selected

GridViewRow كائن هو المحدد.

إلى تحدد الحالة GridViewRowالكائن، استخدم RowStateخاصية.

Th هو خاصية هو موروثة من GridViewالفصل الدراسي و هو غير قابل للتطبيق Rowsعنصر التحكم. To determine the index of a GridViewRow object in the Rows collection, use the RowIndex property.

You can access the properties of the underlying data object that is bound to the GridViewRow object by using the DataItem property.

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

The DataItem property is available only during and after the RowDataBound event of a GridView control.

يمثل DataItemIndexالحقل الذي يتيح لك إلى إنشاء cusإلىm بالترحيل بواجهة المستخدم.

يمكنك الوصول إلى خلايا فردية من GridViewRowكائن باستخدام Cellsخاصية. استخدام Controlsالكائن إلى عناصر تحكم التصفح dهوplay التي تمكن المستخدمين من الصفحة من خلال بيانات التي هو dهوplayed بعنصر تحكم الذي يطبق الواجهة. (مثال هو FindControlالتحكم.)ID

To retrieve a field value from a BoundField field column or an automatically generated field column, use the Text property of the cell. تتضمن سلسلة تنسيق العناصر لعرض اسم مستخدم.

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

القيمة افتراضية هو "{0}".TemplateField سلسلة التنسيق غير صالح.DataBoundLiteralControl DataBoundLiteralControl خاصية يحتوي تشغيل سلسلة تنسيق نص قياسية التي تعرض اسم مستخدم تشغيل صفحة ويب.Text

للحصول على قائمة قيم الخصائص الأولية لمثيل GridViewRow، انظر GridViewRowالمنشئ.

يمكنك أيضا استخدام GridViewRowكائن لعرض معلومات حول مصدر بيانات الأساسي، مثل العدد الإجمالي للسجلات و الصفحة الحالية. رقمGridView



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

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

  void AuthorsGridView_SelectedIndexChanged(Object sender, EventArgs e)
  {

    // Get the selected row from the GridView control.
    GridViewRow selectRow = AuthorsGridView.SelectedRow;

    // Get the author's first and last name from the appropriate
    // cells in the selected row. For BoundField field columns
    // and automatically generated field columns, the Text property
    // of a cell is used to access a field value.
    String lastName = selectRow.Cells[1].Text;

    // In a TemplateField column where a data-binding expression
    // is used directly in the ItemTemplate, the field value
    // is automatically placed in DataBoundLiteral control.

    // Retrieve the DataBoundLiteral control from the cell. The
    // DataBoundLiteral control is the first control in the 
    // Controls collection.
    DataBoundLiteralControl firstNameLiteral = (DataBoundLiteralControl)selectRow.Cells[2].Controls[0];
    String firstName = firstNameLiteral.Text;

    // Display the name of the selected author.
    Message.Text = "You selected " + firstName + " " + lastName + ".";

  }

</script>

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

      <h3>GridViewRow Example</h3>

      <asp:label id="Message" 
        forecolor="Red"
        runat="server"/>

      <br/> 

      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateselectbutton="true"
        onselectedindexchanged="AuthorsGridView_SelectedIndexChanged"  
        runat="server"> 

        <columns>
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
          <asp:templatefield headertext="FirstName">
            <itemtemplate>
              <%#Eval("au_fname")%>
            </itemtemplate>
          </asp:templatefield>
        </columns>

      </asp:gridview>

      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>

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



The following example demonstrates how to use a GridViewRow object to retrieve a TextBox control declared in a TemplateField field column's edit item template. ولذلك، يجب إنشاء التخطيط بوضوح في SqlDataSourceالقالب.

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

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب 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">
<script runat="server">

  void AuthorsGridView_RowUpdating (Object sender, GridViewUpdateEventArgs e)
  {

    // In this example, the GridView control will not automatically extract 
    // updated values from TemplateField column fields because they are not
    // using a two-way binding expression. So, the updated
    // values must be added manually to the NewValues dictionary.

    // Get the GridViewRow object that represents the row being edited
    // from the Rows collection of the GridView control.
    int index = AuthorsGridView.EditIndex;
    GridViewRow row = AuthorsGridView.Rows[index];

    // Get the controls that contain the updated values. In this
    // example, the updated values are contained in the TextBox 
    // controls declared in the EditItemTemplates of the TemplateField 
    // column fields in the GridView control.
    TextBox lastName = (TextBox)row.FindControl("LastNameTextBox");
    TextBox firstName = (TextBox)row.FindControl("FirstNameTextBox");

    // Add the updated values to the NewValues dictionary. Use the
    // parameter names declared in the parameterized update query 
    // string for the key names.
    e.NewValues["au_lname"] = lastName.Text;
    e.NewValues["au_fname"] = firstName.Text;    

  }

</script>

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

      <h3>GridViewRow Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames attribute as read-only    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        datakeynames="au_id"
        cellpadding="10"
        onrowupdating="AuthorsGridView_RowUpdating"      
        runat="server">

        <columns>

          <asp:boundfield datafield="au_id"
            headertext="Author ID"
            readonly="true"/>

          <asp:templatefield headertext="Last Name"
            itemstyle-verticalalign="Top">

            <itemtemplate>
              <%#Eval("au_lname")%>
            </itemtemplate>

            <edititemtemplate>
              <asp:textbox id="LastNameTextBox"
                text='<%#Eval("au_lname")%>'
                width="90"
                runat="server"/>
              <br/>
              <asp:requiredfieldvalidator id="LastNameRequiredValidator"
                controltovalidate="LastNameTextBox"
                display="Dynamic"
                text="Please enter a last name." 
                runat="server" />                                      
            </edititemtemplate>

          </asp:templatefield>

          <asp:templatefield headertext="First Name"
            itemstyle-verticalalign="Top">

            <itemtemplate>
              <%#Eval("au_fname")%>
            </itemtemplate>

            <edititemtemplate>
              <asp:textbox id="FirstNameTextBox"
                text='<%#Eval("au_fname")%>'
                width="90"
                runat="server"/>
              <br/>
              <asp:requiredfieldvalidator id="FirstNameRequiredValidator"
                controltovalidate="FirstNameTextBox"
                display="Dynamic"
                text="Please enter a first name."
                runat="server" />                      
            </edititemtemplate>

          </asp:templatefield>

          <asp:checkboxfield datafield="contract" 
            headertext="Contract"
            readonly="true"/>

        </columns>

      </asp:gridview>

      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_id], [au_lname], [au_fname], [contract] FROM [authors]"             
        updatecommand="UPDATE authors SET au_lname=@au_lname, au_fname=@au_fname WHERE (authors.au_id = @au_id)" 
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>

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