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.

GridView.RowCommand الحدث

Visual Studio 2010

GridView حدث هو raهوed عند رابط لفرز عمود هو النقر فوقه، ولكن بعد مقابض التحكم في عملية فرز.

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

public event GridViewCommandEventHandler RowCommand
<asp:GridView OnRowCommand="GridViewCommandEventHandler" />

قم بإنشاء صف في RowCommandعنصر تحكم.GridView الجميع خصائص في the الحالي مثيل of the فئة will be replaced بواسطة the corresponding خصائص في the specified كائن.

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

قيمة commandname

الوصف

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

يتيح لك ذلك إلى توفير أسلوب معالجة حدث الذي يجري روتين cusإلىm، مثل فرز cusإلىm، عند إجراء هذا حدث.GridView يقوم برفع حدث RowCancelingEdit.

"يحذف"

قم بحذف الحالي سجل. يرفع RowDeletingو RowDeletedالأحداث.

"تحرير"

يتيح لك ذلك إلى توفير أسلوب معالجة حدث الذي يقوم روتين cusإلىm، مثل يتم إلغاء الأمر عملية فرز، عند إجراء هذا حدث. يقوم برفع حدث RowEditing.

"الصفحة"

يقوم ترحيل تشغيل. CommandArgument الذي يحتوي على بيانات المصدر. يرفع PageIndexChangingو PageIndexChangedالأحداث.

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

يؤسس عنصر تحكم هيكلي. يرفع SelectedIndexChangingو SelectedIndexChangedالأحداث.

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

Th هو أسلوب هو المستخدمة ل establهوh هيكلي لعنصر التحكم عن GridViewعنصر التحكم. يرفع Sortingو Sortedالأحداث.

"تحديث"

قم بتحديث الحالي سجل في مصدر بيانات. يرفع RowUpdatingو RowUpdatedالأحداث.

على الرغم من أن RowCommandتشغيل حدث عند زر في السابق يتم النقر فوق جدول، فمن المستحسن أن تستخدم الأحداث المسرودة في الجدول للعملية.

GridViewCommandEventArgs استخدام إلى تقديم محتوى عنصر تحكم الخادم تشغيل مستعرض العميل.

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

CommandArgument الذي يحتوي على قيم الحالة المحفوظة لطريقة العرض عنصر تحكم. بفرز ButtonFieldعنصر تحكم يستند إلى تعبير فرز المحدد و الاتجاه.CommandArgument The فرز تعبير مع which إلى فرز the CommandArgument عنصر تحكم. The CommandArgument عنصر تحكم هو حدود إلى a data التحكم بالمصادر, but the <%# Container.DataItemIndex %> that هو associated مع the مصدر البيانات هو GridView.

للحصول على مزيد من المعلومات حول معالجة الأحداث، راجع استهلاك الأحداث.

استخدم the RowCommand أسلوب إلى programmatically sort the GridView عنصر تحكم using the specified sort تعبير و direction. ListBox



<%@ 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 ContactsGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
    // If multiple buttons are used in a GridView control, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Add")
    {
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);

      // Retrieve the row that contains the button clicked 
      // by the user from the Rows collection.
      GridViewRow row = ContactsGridView.Rows[index];

      // Create a new ListItem object for the contact in the row.     
      ListItem item = new ListItem();
      item.Text = Server.HtmlDecode(row.Cells[2].Text) + " " +
        Server.HtmlDecode(row.Cells[3].Text);

      // If the contact is not already in the ListBox, add the ListItem 
      // object to the Items collection of the ListBox control. 
      if (!ContactsListBox.Items.Contains(item))
      {
        ContactsListBox.Items.Add(item);
      }
    }
  }    
</script>

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

      <h3>GridView RowCommand Example</h3>

      <table width="100%">
        <tr>
          <td style="width:50%">

            <asp:gridview id="ContactsGridView" 
              datasourceid="ContactsSource"
              allowpaging="true" 
              autogeneratecolumns="false"
              onrowcommand="ContactsGridView_RowCommand"
              runat="server">

              <columns>
                <asp:buttonfield buttontype="Link" 
                  commandname="Add" 
                  text="Add"/>
                <asp:boundfield datafield="ContactID" 
                  headertext="Contact ID"/>
                <asp:boundfield datafield="FirstName" 
                  headertext="First Name"/> 
                <asp:boundfield datafield="LastName" 
                  headertext="Last Name"/>
              </columns>

            </asp:gridview>

          </td>

          <td style="vertical-align:top; width:50%">

            Contacts: <br/>
            <asp:listbox id="ContactsListBox"
              runat="server" Height="200px" Width="200px"/>

          </td>
        </tr>
      </table>

      <!-- 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="ContactsSource"
        selectcommand="Select [ContactID], [FirstName], [LastName] From Person.Contact"
        connectionstring="<%$ ConnectionStrings:AdventureWorks_DataConnectionString%>" 
        runat="server"/>

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



The فرز تعبير specifies the عمود أو columns مع which إلى فرز.RowCommand This example has the paging functionality enabled for the GridView control and sets the CommandArgument property of the Button control to the appropriate row index.



<%@ 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 ProductsGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
    // If multiple buttons are used in a GridView control, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Increase")
    {
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);

      // Retrieve the row that contains the button clicked 
      // by the user from the Rows collection.      
      GridViewRow row = ProductsGridView.Rows[index];

      // Calculate the new price.
      Label listPriceTextBox = (Label)row.FindControl("PriceLabel");
      listPriceTextBox.Text = (Convert.ToDouble(listPriceTextBox.Text) * 1.05).ToString();     

      // Update the row.
      ProductsGridView.UpdateRow(index, false);
    }
  }
</script>

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

      <h3>GridView RowCommand Example</h3>

      <asp:GridView id="ProductsGridView" 
        DataSourceID="ProductsDataSource"
        DataKeyNames="ProductID"
        AllowPaging="True" 
        OnRowCommand="ProductsGridView_RowCommand"
        AutoGenerateColumns="False"
        runat="server">
        <Columns>
          <asp:BoundField DataField="Name" HeaderText="Product Name" />
          <asp:BoundField DataField="ProductNumber" HeaderText="Product Number" />          
          <asp:TemplateField HeaderText="Price">
            <ItemTemplate>
              <asp:Label ID="PriceLabel" runat="server" 
                Text='<%# Bind("ListPrice") %>'>
              </asp:Label>
            </ItemTemplate>
          </asp:TemplateField>
          <asp:TemplateField>
            <ItemTemplate>                
              <asp:Button runat="server" ID="IncreaseButton"
                Text="Increase Price 5%"
                CommandName="Increase"
                CommandArgument="<%# ((GridViewRow) Container).RowIndex %>" />
            </ItemTemplate>
          </asp:TemplateField>
        </Columns>
      </asp:GridView>

      <!-- 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"
        SelectCommand="SELECT [ProductID], [Name], [ProductNumber], [ListPrice] 
          FROM Production.Product 
          WHERE ListPrice &lt;&gt; 0"
        UpdateCommand="UPDATE Production.Product SET [ListPrice] = @ListPrice 
          WHERE [ProductID] = @ProductID"
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        runat="server" />

    </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

التاريخ

المحفوظات

السبب

Th هو أسلوب هو أيضا استخداماً برمجياً بتعيين ترتيب فرز افتراضي ل في التحكم عند ذلك هو عرض أولاً.

ملاحظات العميل.

إظهار: