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.

CommandField الفئة

Visual Studio 2010

مسار قيمة هو مفصولة بمحدد lهوt قيم عنصر القائمة الذي يشكل مساراً من عنصر القائمة الجذر لعنصر القائمة الحالي.

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

public class CommandField : ButtonFieldBase

The CommandField class is a special field used by data-bound controls (such as GridView and DetailsView) to display command buttons that perform delete, edit, insert, or select operations. يوضح المثال التالي كيفية إلى عرض لعنصر قائمة والأصل عند تحديد عنصر القائمة.

الخصائص

الوصف

ShowDeleteButton

يحصل على مسار من الجذر عنصر قائمة إلى الحالي عنصر قائمة.CommandField أ المحدد-منفصلة قائمة قيم عنصر القائمة التي تشكل مساراً من عنصر القائمة الجذر لعنصر القائمة الحالي.

ShowEditButton

CommandField تحتوي خاصية على قائمة مفصولة بمحدد من القائمة العنصر قيم التي تشكل مساراً من جذر عنصر القائمة إلى الحالي القائمة العنصر. يمكنك تعيين المحدد أن الحرف المستخدم إلى قم بفصل قيم عنصر قائمة باستخدام خاصية. Th هو قيمة هو شائع عند تحليل lهوt للقيم الفردية، أو تمرير كوسيطة إلى طريقة class. بناء تشغيل القيمة المعروضة في عنصر تحكم، قد تحتاج حرف المحدد للتغيير لمنع أية تعارضات.

ShowInsertButton

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

ملاحظةملاحظة
قم بإنشاء نسخ من الحالي DetailsViewكائن.

ShowSelectButton

CommandField الذي يمثل نسخ من . هو أسلوب يستخدمه الفئة إلى إجراء نسخ عن نفسه.

بشكل عام، يجب عليك استخدام ShowCancelButtonعضو لتحديد ما إذا كان الكائن هو تعقب تغييرات الولاية العرض.

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

التحميلات سابقا تم الحفظ عنصر قائمة عرض الالولاية.SqlDataSource قم بحفظ التغييرات الولاية العرض إلى .

CommandField يحتوي على تغييرات الولاية العرض. For example, the GridView control displays a CommandField field as a column, while the DetailsView control displays it as a row.

لتعيين النوع زر لعرض، استخدم ButtonTypeخاصية. When the ButtonType property is set to ButtonType.Button or ButtonType.Link, you can specify the text to display for the buttons by setting the properties shown in the following table.

الخصائص

الوصف

CancelText

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

DeleteText

إذا كنت تريد عنصر قائمة لإظهار أي فرع عناصر، ولكن لا تكون "قابله النقر" نفسه، استخدم خاصية و تعيينها إلى .

EditText

يوضح المثال التالي كيفية عنصر قائمة مع تعيين خاصية إلى يظهر و الدالات في القائمة.

InsertText

الحصول أو تعيين القيمة تشير إلى ما إذا كان يمكن تحديد كائن، أو هو "قابله للنقر."

ملاحظةملاحظة
DetailsView إذا كان عنصر قائمة يمكن أن تكون؛ وإلا،.

NewText

عندما th هو خاصية هو معينة إلى بعنصر قائمة، لا يوجد إجراء يحدث عند عنصر القائمة هو بالنقر فوق (المحدد).

ملاحظةملاحظة
DetailsView إذا كان عنصر قائمة يمكن أن تكون؛ وإلا،.

SelectText

تشير إلى عناصر قائمة التابعة لعنصر قائمة، إذا كان ملف الصورة المنبثقة exهوts، هو لا يزال المعروض ومتوفرة.

UpdateText

إذا كنت لا تريد أي فرع عناصر القائمة إظهار عنصر قائمة، قم بتعيين خاصية إلى .

ButtonType يطبق فقط إلى عناصر القائمة التي يمكن تحديدها في ذات معنى أن بالنقر فوق عنصر قائمة عمليات النشر خلف وقم بتعيين هذا العنصر في حالة محددة.ButtonType.Image

الخصائص

الوصف

CancelImageUrl

لاحظ أن قائمة العنصر الذي لا يمكن تحديدها هو لا يزال منسقة كارتباط.

DeleteImageUrl

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

EditImageUrl

أيضا، عنصر القائمة، حتى أنه لا يمكن محددها، قد يكون للطفل عنصر القائمة s يمكن محدده أو التي تحتاج إلى عرض.

InsertText

إذا كنت تريد إلى منع مستخدم من النقر فوق أحد عناصر قائمة، قم بأحد الإجراءات التالية:

ملاحظةملاحظة
DetailsView إذا كان عنصر قائمة يمكن أن تكون؛ وإلا،.

NewImageUrl

Do not التعيينو التعيينإلى.

ملاحظةملاحظة
DetailsView إذا كان عنصر قائمة يمكن أن تكون؛ وإلا،.

SelectImageUrl

قم بتعيين خاصية إلى لعنصر قائمة .

UpdateImageUrl

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

عنصر تحكم s تدعم الحدود الفاصلة للصفحات غالباً بتوفير التعيين من عنصر تحكم s تسمى النداء التي تسمح للمستخدم بالتنقل بين الصفحات الموجودة داخل عنصر تحكم.CommandField CausesValidation يمثل قائمة تعداد مواقع? مختلفة بحيث يمكن عرضها في النداء.false

يوضح المثال تعليمات برمجية التالي كيفية استخدام CommandFieldالتعداد لتعيين أنه يجب عرض النداء أسفل Visibleعنصر التحكم.false

نداء توضع في الأسفل عنصر تحكم.CommandField To display a caption in the header or the footer section, set the HeaderText or the FooterText property, respectively. Pagers positioned at كلاهما the الأعلى و the bottom of the عنصر تحكم.HeaderImageUrl To hide the header section in a CommandField object, set the ShowHeader property to false.

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

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

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

خاصية نمط

الوصف

ControlStyle

إظهار أو إخفاء زر يحذف في CommandFieldحقل لكل سجل في عنصر تحكم حدود بيانات.

FooterStyle

اليحذف زر تسمح للمستخدم بيحذف سجل من مصدر بيانات.CommandField

HeaderStyle

إظهار أو إخفاء زر تحرير في CommandFieldحقل لكل سجل في عنصر تحكم حدود بيانات.

ItemStyle

التحرير زر تسمح للمستخدم بتحرير أحد سجلات من مصدر بيانات.CommandField

The following code example demonstrates how to use a CommandField field to display controls to edit a record 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>CommandField Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">

        <columns>
          <asp:commandfield showeditbutton="true"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>

      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>

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



The following code example demonstrates how to use the CancelText, EditText, and UpdateText properties to customize the text for the editing controls.



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

      <h3>CommandField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        datakeynames="CustomerID"  
        runat="server">

        <columns>
          <asp:commandfield showeditbutton="true"
            edittext="Edit Customer"
            canceltext="Discard"
            updatetext="Revise"
            headertext="Edit Controls"/>
          <asp:boundfield datafield="CustomerID"
            headertext="Customer ID" />
          <asp:boundfield datafield="CompanyName"
            headertext="Company Name"/>
          <asp:boundfield datafield="Address"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            headertext="Country"/>
        </columns>

      </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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        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
إظهار: