ButtonField Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Olyan mezőt jelöl, amely gombként jelenik meg egy adathoz kötött vezérlőelemben.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase

public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase

type ButtonField = class
    inherit ButtonFieldBase

Public Class ButtonField
Inherits ButtonFieldBase

Öröklődés: Object

DataControlField

ButtonFieldBase
ButtonField

Példák

Az alábbi példakód bemutatja, hogyan jeleníthet meg parancsgombok oszlopát egy vezérlőben ButtonField egy objektummalGridView.


<%@ 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>


<%@ Page language="VB" %>


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

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</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>

Megjegyzések

Az ButtonField osztályt adathoz kötött vezérlők (például GridView és DetailsView) használják az egyes megjelenített rekordok gombjának megjelenítéséhez. Az ButtonField objektum másként jelenik meg attól függően, hogy melyik adathoz kötött vezérlőelemben használják. A vezérlő például GridView oszlopként jeleníti meg ButtonField az objektumot, míg a DetailsView vezérlőelem sorként jeleníti meg.

Ha egy gombmezőben egy gombra kattint, a szülő adathoz kötött vezérlőelem parancseseménye aktiválható. A parancsgombra kattintva egyéni rutint adhat meg, ha megad egy eseménykezelőt a parancseseményhez.

Note

A GridView vezérlő az eseményt, RowCommand a DetailsView vezérlő pedig az eseményt ItemCommand emeli ki.

A parancseseményt szabályzó rekord indexének meghatározásához használja az CommandArgument adathoz kötött vezérlőelem parancseseményének átadott eseményargumentum tulajdonságát. Az ButtonField osztály automatikusan feltölti a CommandArgument tulajdonságot a megfelelő indexértékkel.

A megjelenítendő gomb típusának megadásához használja a tulajdonságot ButtonType . Hivatkozás vagy parancsgomb megjelenítésekor a Text tulajdonság használatával adja meg a gombokban megjelenítendő feliratot.

Note

Ha beállítja a tulajdonságot, a Text felirat minden ButtonField gombja ugyanazzal a felirattal rendelkezik.

Azt is megteheti, hogy egy adatforrás egy mezőjéhez köti az ButtonField objektumot. Így különböző feliratokat jeleníthet meg az ButtonField objektum gombjaihoz. A megadott mezőben szereplő értékek a gombok szövegfelirataihoz használatosak. Állítsa be a DataTextField tulajdonságot úgy, hogy egy objektumot ButtonField egy adatforrás egyik mezőjéhez kössön.

Kép gomb megjelenítésekor a ImageUrl tulajdonság használatával adja meg az objektum gombjaihoz ButtonField megjelenítendő képet.

Note

Az ButtonField objektum összes gombja ugyanazt a képet használja.

A tulajdonság beállításával ButtonField elrejthet egy Visible objektumot egy adathoz kötött vezérlőelembenfalse.

Az ButtonField objektum lehetővé teszi az élőfej- és élőlábszakaszok testreszabását. Ha feliratot szeretne megjeleníteni az élőfej vagy élőláb szakaszban, állítsa be a tulajdonságokat vagy HeaderText a FooterText tulajdonságokat. Ahelyett, hogy szöveget jelenítenének meg a fejlécszakaszban, a tulajdonság beállításával HeaderImageUrl megjeleníthet egy képet. Ha el szeretné rejteni a fejlécszakaszt egy ButtonField objektumban, állítsa a tulajdonságot a ShowHeader következőre false: .

Note

Egyes adathoz kötött vezérlők (például a GridView vezérlő) csak a vezérlő teljes fejlécszakaszát jeleníthetik meg vagy rejthetik el. Ezek az adathoz kötött vezérlők nem támogatják az ShowHeader egyes gombmezők tulajdonságát. Az adatkötött vezérlőelem teljes fejlécszakaszának megjelenítéséhez vagy elrejtéséhez (ha van ilyen) használja a ShowHeader vezérlőelem tulajdonságát.

Az objektum megjelenését ButtonField (betűszín, háttérszín stb.) a mező különböző részei stílustulajdonságainak beállításával is testre szabhatja. Az alábbi táblázat a különböző stílustulajdonságokat sorolja fel.

Stílus tulajdonság	A stílusbeállítások a következőhöz:
ControlStyle	A gyermek webkiszolgáló vezérlői a ButtonField.
FooterStyle	A lábléc szakasza.ButtonField
HeaderStyle	A fejlécszakasz.ButtonField
ItemStyle	ButtonFieldA .

Konstruktorok

Név	Description
ButtonField()	Inicializálja a ButtonField osztály új példányát.

Tulajdonságok

Név	Description
AccessibleHeaderText	Lekéri vagy beállítja bizonyos vezérlők tulajdonságértékeként `AbbreviatedText` megjelenített szöveget. (Öröklődés forrása DataControlField)
ButtonType	Lekéri vagy beállítja a gombtípust, hogy megjelenjen a gombmezőben. (Öröklődés forrása ButtonFieldBase)
CausesValidation	Lekéri vagy beállít egy értéket, amely jelzi, hogy az ellenőrzés akkor történik-e, amikor egy ButtonFieldBase objektum egyik gombjára kattint. (Öröklődés forrása ButtonFieldBase)
CommandName	Lekéri vagy beállít egy sztringet, amely azt a műveletet jelöli, amelyet egy objektum egyik gombjának ButtonField kattintásakor hajt végre.
Control	Az objektumhoz társított adatvezérlőre DataControlField mutató hivatkozást kap. (Öröklődés forrása DataControlField)
ControlStyle	Lekéri az objektum által tartalmazott webkiszolgáló-vezérlők stílusát DataControlField . (Öröklődés forrása DataControlField)
DataTextField	Lekéri vagy beállítja annak az adatmezőnek a nevét, amelyhez az érték az objektum által Text renderelt vezérlőelem tulajdonságához Button van kötveButtonField.
DataTextFormatString	Lekéri vagy beállítja a mező értékének megjelenítési formátumát meghatározó sztringet.
DesignMode	Beolvas egy értéket, amely jelzi, hogy egy adatvezérlő mező jelenleg tervezőkörnyezetben van-e megtekintve. (Öröklődés forrása DataControlField)
FooterStyle	Lekéri vagy beállítja az adatvezérlő mező láblécének stílusát. (Öröklődés forrása DataControlField)
FooterText	Lekéri vagy beállítja az adatvezérlő mező láblécelemében megjelenő szöveget. (Öröklődés forrása DataControlField)
HeaderImageUrl	Lekéri vagy beállítja egy kép URL-címét, amely egy adatvezérlő mező fejlécelemében jelenik meg. (Öröklődés forrása DataControlField)
HeaderStyle	Lekéri vagy beállítja az adatvezérlő mező fejlécének stílusát. (Öröklődés forrása DataControlField)
HeaderText	Lekéri vagy beállítja az adatvezérlő mező fejlécelemében megjelenő szöveget. (Öröklődés forrása DataControlField)
ImageUrl	Lekéri vagy beállítja a kép megjelenítését az ButtonField objektum egyes gombjaihoz.
InsertVisible	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum látható-e, ha a szülő adatkötésű vezérlőelem beszúrási módban van. (Öröklődés forrása DataControlField)
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum menti-e a nézetállapot módosításait. (Öröklődés forrása DataControlField)
ItemStyle	Lekéri az adatvezérlő mező által megjelenített szövegalapú tartalom stílusát. (Öröklődés forrása DataControlField)
ShowHeader	Lekéri vagy beállít egy értéket, amely jelzi, hogy a fejlécszakasz megjelenik-e egy ButtonFieldBase objektumban. (Öröklődés forrása ButtonFieldBase)
SortExpression	Lekéri vagy beállítja az adatforrás-vezérlő által az adatok rendezésére használt rendezési kifejezést. (Öröklődés forrása DataControlField)
Text	Lekéri vagy beállítja az objektum egyes gombjaihoz ButtonField megjelenített statikus feliratot.
ValidateRequestMode	Lekéri vagy beállít egy értéket, amely meghatározza, hogy a vezérlő ellenőrzi-e az ügyfélbemenetet. (Öröklődés forrása DataControlField)
ValidationGroup	Lekéri vagy beállítja az érvényesítési vezérlők csoportjának nevét annak ellenőrzésére, hogy egy objektum egyik ButtonFieldBase gombjára kattint-e. (Öröklődés forrása ButtonFieldBase)
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását DataControlField ugyanazon lap több kérésében. (Öröklődés forrása DataControlField)
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy adatvezérlő mező renderelve van-e. (Öröklődés forrása DataControlField)

Metódusok

Név	Description
CloneField()	Másolatot készít az aktuális DataControlFieldszármaztatott objektumról. (Öröklődés forrása DataControlField)
CopyProperties(DataControlField)	Másolja az aktuális ButtonField objektum tulajdonságait a megadott DataControlField objektumba.
CreateField()	Létrehozza és visszaadja az osztály új példányát ButtonField .
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Kinyeri az adatvezérlő mező értékét az aktuális táblázatcellából, és hozzáadja az értéket a megadott IDictionary gyűjteményhez. (Öröklődés forrása DataControlField)
FormatDataTextValue(Object)	Az objektum egy cellájának megadott mezőértékének formázása ButtonField .
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Initialize(Boolean, Control)	Inicializálja az aktuális ButtonField objektumot.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializálja a megadott DataControlFieldCell objektumot a megadott sorállapotba.
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása DataControlField)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnFieldChanged()	Az eseményt emeli `FieldChanged` ki. (Öröklődés forrása DataControlField)
SaveViewState()	Menti a DataControlField nézetállapot módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása DataControlField)
ToString()	Az objektumot jelképező DataControlField sztringet ad vissza. (Öröklődés forrása DataControlField)
TrackViewState()	Ez azt eredményezi, hogy az DataControlField objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState tulajdonságában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása DataControlField)
ValidateSupportsCallback()	Meghatározza, hogy az objektumban ButtonField található vezérlők támogatják-e a visszahívásokat.

Explicit interfész-implementációk

Név	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Lekéri vagy beállítja az objektumhoz DataControlField társított sémát. (Öröklődés forrása DataControlField)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az DataControlField objektum menti-e a nézetállapot módosításait. (Öröklődés forrása DataControlField)
IStateManager.LoadViewState(Object)	Visszaállítja az adatvezérlő mező korábban mentett nézetállapotát. (Öröklődés forrása DataControlField)
IStateManager.SaveViewState()	Menti a DataControlField nézetállapot módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása DataControlField)
IStateManager.TrackViewState()	Ez azt eredményezi, hogy az DataControlField objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState tulajdonságában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása DataControlField)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?