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.

ButtonField المنشئ

Visual Studio 2010

تهيئة مثيل جديد من فئة ال ButtonField.

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

public ButtonField()

على الرغم من ذلك، ButtonFieldتؤثر خاصية على كل عقده كتابته هو المحدد بواسطة خاصية؛ ولذلك، ButtonFieldخاصية هو غالباً لتجاوز هذا إعداد لعقدة التي الكائن هو تطبيق. إظهار أو إخفاء جديد زر في الحقل.

استخدام ButtonFieldخاصية إلى لتحديد عدد عناصر إلى عرض تشغيل صفحة واحدة.ButtonField For example, if you are using the GridView control, add the ButtonField object to the Columns collection.


يحصل كائن التي يمكن استخدامها لمزامنة وصول إلى المجموعة. الاسم هو تعيين باستخدام خاصية.

The following code example demonstrates how to use the M:System.Web.UI.WebControls.ButtonField.#ctor constructor to add a ButtonField object dynamically to a GridView control.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)

    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.

      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    

      // Get the last name of the selected Customer from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactCell = selectedRow.Cells[1];
      string contact = contactCell.Text;  

      // Display the selected Customer.
      Message.Text = "You selected " + contact + ".";



  void Page_Load(Object sender, EventArgs e)

    // The field columns need to be created only the first time
    // the page is loaded.
    if (!IsPostBack)

      // Dynamically create field columns to display the desired
      // fields from the data source.

      // Create a ButtonField object to allow the user to 
      // select an Customer.
      ButtonField selectButtonField = new ButtonField ();

      selectButtonField.ButtonType = ButtonType.Button;
      selectButtonField.CommandName = "Select";
      selectButtonField.HeaderText = "Select Customer";
      selectButtonField.Text = "Select";

      // Create a BoundField object to display an Customer's last name.
      BoundField contactNameBoundField = new BoundField();

      contactNameBoundField.DataField = "ContactName";
      contactNameBoundField.HeaderText = "Contact Name";

      // Create a BoundField object to display an Customer's first name.
      BoundField contactTitleBoundField = new BoundField();

      contactTitleBoundField.DataField = "ContactTitle";
      contactTitleBoundField.HeaderText = "Contact Title";

      // Add the field columns to the Columns collection of the
      // GridView control.
      CustomersGridView.Columns.Add (selectButtonField);




<html xmlns="" >
  <head runat="server">
    <title>ButtonField Constructor Example</title>
    <form id="form1" runat="server">

      <h3>ButtonField Constructor Example</h3>

      <asp:label id="Message"

      <asp:gridview id="CustomersGridView" 

        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"


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