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

استخدام الخاصية لتحديد ما إذا كان الصفحة الحالي الصفحة الأولى.

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

public class ButtonField : ButtonFieldBase

The ButtonField class is used by data-bound controls (such as GridView and DetailsView) to display a button for each record that is displayed. ButtonField الذي يمثل تقديم في يوم . For example, the GridView control displays a ButtonField object as a column, while the DetailsView control displays it as a row.

النقر فوق أي زر في حقل زر رفع حدث الأمر ربط البيانات الأصل عنصر تحكم. إذا الصفحة الحالي هي الصفحة الأخيرة؛ وإلا.

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

The GridView control raises the RowCommand event, while the DetailsView control raises the ItemCommand event.

يحصل على القيمة للإشارة إلى ما إذا كان الترحيل هو ممكنة.CommandArgument بفرز ButtonFieldعنصر تحكم يستند إلى تعبير فرز المحدد و الاتجاه.CommandArgument

لتعيين النوع زر لعرض، استخدم ButtonTypeخاصية. استخدام Textخاصية لتحديد ما إذا كان الترحيل هو ممكنة.

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

Text يجب أن تكون خاصية ButtonFieldو لا يمكن أن تكون الخاصية التعيين إلى 0 لهذه الخاصية لإرجاع .

الحصول القيمة تشير إلى ما إذا كانت بيانات المصدر هو للقراءة فقط.ButtonField Th هو خاصية هو تنفيذ دوماً بإرجاع ButtonField، الذي يشير إلى أنه يمكن ‏‏تاريخ التعديل مصدر بيانات في الجميع الحالات. يحصل على القيمة للإشارة إلى ما إذا كان من جانب الملقم الترحيل بدعم هو ممكنة. DataTextField إذا كان الترحيل هو الترحيل الممكنة ومن جانب الخادم هو المشار إليها باستخدامButtonFieldخاصية؛ otherwهوe،.

ترحيل الصفحات للملقم هو ممكنة عند ImageUrlو ButtonFieldالخصائص يتم تعيين كلا ، ومقدار بيانات التي تم استردادها بواسطة مصدر بيانات لا يمكن أن يكون dهوplayed في صفحة واحدة.

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

إحضار الالقيمة للإشارة إلى ما إذا كان الوصول إلى مصدر بيانات هو متزامنة (مؤشر ترابط-الأمن).ButtonField

You can hide a ButtonField object in a data-bound control by setting the Visible property to false.

Th هو خاصية هو مشتقة من ButtonFieldفئة و هو تجاوز دوماً بإرجاع للإشارة إلى ذلك th هو الفئة هو مؤشر ترابط غير-اﻷمن. To display a caption in the header or footer section, set the HeaderText or FooterText properties, respectively. Pagers positioned at كلاهما the الأعلى و the bottom of the عنصر تحكم.HeaderImageUrl To hide the header section in a ButtonField object, set the ShowHeader property to false.

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

بعض بيانات منضم عنصر تحكم s (مثل GridViewعنصر تحكم) يمكنك إظهار أو إخفاء مقطع الرأس بالكامل من عنصر تحكم. لا يدعم عناصر تحكم حدود بيانات ShowHeaderخاصية لفرد زر الحقل. لإظهار أو إخفاء مقطع الرأس بأكمله من ربط البيانات عنصر تحكم (إذا كانت متوفرة)، استخدام ShowHeaderخاصية عنصر تحكم.

butإلىns الأمر إلى إجراء هذه العمليات يمكن إظهارها أو المخفية باستخدام الخصائص عرض في الجدول التالي.ButtonField يسرد الجدول التالي خصائص النمط آخر.

خاصية نمط

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

ControlStyle

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

FooterStyle

استخدام ButtonFieldخاصية إلى لتحديد عدد الصفحات الضرورية إلى عرض كل العناصر في مصدر بيانات.

HeaderStyle

إذا ButtonFieldخاصية هو تعيين إلى أو خاصية هو معينة إلى 1 صفر أو أقل، هو التي يتم إرجاعها.

ItemStyle

الحصول أو تعيين عدد عناصر إلى عرض تشغيل صفحة واحدة.ButtonField

The following code example demonstrates how to use a ButtonField object to display a column of command buttons in a GridView control.



<%@ 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 CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {

    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {

      // 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 author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  

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

    }

  }

</script>

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

      <h3>ButtonField Example</h3>

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

      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">

        <columns>

          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>

        </columns>

      </asp:gridview>

        <!-- 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%>"
          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
إظهار: