ButtonField Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een veld dat wordt weergegeven als een knop in een gegevensgebonden besturingselement.

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

Overname: Object

DataControlField

ButtonFieldBase
ButtonField

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een ButtonField object gebruikt om een kolom met opdrachtknoppen in een GridView besturingselement weer te geven.


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

Opmerkingen

De ButtonField klasse wordt gebruikt door gegevensgebonden besturingselementen (zoals GridView en DetailsView) om een knop weer te geven voor elke record die wordt weergegeven. Het ButtonField object wordt anders weergegeven, afhankelijk van het gegevensgebonden besturingselement waarin het wordt gebruikt. Het besturingselement geeft bijvoorbeeld GridView een ButtonField object weer als een kolom, terwijl het DetailsView besturingselement het weergeeft als een rij.

Als u op een knop in een knopveld klikt, wordt de opdrachtgebeurtenis van het bovenliggende gegevensgebonden besturingselement gegenereerd. U kunt een aangepaste routine opgeven die moet worden uitgevoerd wanneer op een opdrachtknop wordt geklikt door een gebeurtenishandler op te geven voor de opdrachtgebeurtenis.

Note

Het GridView besturingselement verhoogt de RowCommand gebeurtenis, terwijl het DetailsView besturingselement de ItemCommand gebeurtenis verhoogt.

Als u de index wilt bepalen van de record die de opdrachtgebeurtenis genereert, gebruikt u de CommandArgument eigenschap van het gebeurtenisargument dat wordt doorgegeven aan de opdrachtgebeurtenis voor het gegevensgebonden besturingselement. De ButtonField klasse vult de CommandArgument eigenschap automatisch met de juiste indexwaarde.

Als u het type knop wilt opgeven dat moet worden weergegeven, gebruikt u de ButtonType eigenschap. Wanneer u een koppeling of opdrachtknop weergeeft, gebruikt u de Text eigenschap om het bijschrift op te geven dat in de knoppen moet worden weergegeven.

Note

Als u de Text eigenschap instelt, delen alle knoppen in een ButtonField deel hetzelfde bijschrift.

U kunt het ButtonField object ook binden aan een veld in een gegevensbron. Hiermee kunt u verschillende bijschriften voor de knoppen in het ButtonField object weergeven. De waarden die zich in het opgegeven veld bevinden, worden gebruikt voor de tekstbijschriften van de knoppen. Stel de DataTextField eigenschap in om een ButtonField object te binden aan een veld in een gegevensbron.

Wanneer u een afbeeldingsknop weergeeft, gebruikt u de ImageUrl eigenschap om de afbeelding op te geven die moet worden weergegeven voor de knoppen in het ButtonField object.

Note

Alle knoppen in een ButtonField object delen dezelfde afbeelding.

U kunt een ButtonField object verbergen in een gegevensgebonden besturingselement door de Visible eigenschap in te stellen op false.

Met ButtonField het object kunt u de kop- en voettekstsecties aanpassen. Als u een bijschrift wilt weergeven in de kop- of voettekstsectie, stelt u respectievelijk de HeaderText of FooterText eigenschappen in. In plaats van tekst weer te geven in de koptekstsectie, kunt u een afbeelding weergeven door de eigenschap in te HeaderImageUrl stellen. Als u de koptekstsectie in een ButtonField object wilt verbergen, stelt u de ShowHeader eigenschap in op false.

Note

Sommige gegevensgebonden besturingselementen (zoals het GridView besturingselement) kunnen alleen de hele koptekstsectie van het besturingselement weergeven of verbergen. Deze gegevensgebonden besturingselementen bieden geen ondersteuning voor de ShowHeader eigenschap voor een afzonderlijk knopveld. Als u de hele koptekstsectie van een gegevensgebonden besturingselement (indien beschikbaar) wilt weergeven of verbergen, gebruikt u de ShowHeader eigenschap voor het besturingselement.

U kunt ook het uiterlijk van het ButtonField object (tekstkleur, achtergrondkleur, enzovoort) aanpassen door de stijleigenschappen voor de verschillende delen van het veld in te stellen. De volgende tabel bevat de verschillende stijleigenschappen.

Stijleigenschap	De stijlinstellingen voor
ControlStyle	De onderliggende webserverbesturingselementen van de ButtonField.
FooterStyle	De voettekstsectie van de ButtonField.
HeaderStyle	De koptekstsectie van de ButtonField.
ItemStyle	De gegevensitems in de ButtonField.

Constructors

Name	Description
ButtonField()	Initialiseert een nieuw exemplaar van de ButtonField klasse.

Eigenschappen

Name	Description
AccessibleHeaderText	Hiermee wordt tekst opgehaald of ingesteld die wordt weergegeven als de `AbbreviatedText` eigenschapswaarde in sommige besturingselementen. (Overgenomen van DataControlField)
ButtonType	Hiermee haalt u het knoptype op of stelt u dit in om weer te geven in het knopveld. (Overgenomen van ButtonFieldBase)
CausesValidation	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of validatie wordt uitgevoerd wanneer op een knop in een ButtonFieldBase object wordt geklikt. (Overgenomen van ButtonFieldBase)
CommandName	Hiermee haalt u een tekenreeks op die de actie vertegenwoordigt die moet worden uitgevoerd wanneer op een knop in een ButtonField object wordt geklikt.
Control	Hiermee haalt u een verwijzing op naar het gegevensbeheer waaraan het DataControlField object is gekoppeld. (Overgenomen van DataControlField)
ControlStyle	Hiermee haalt u de stijl op van webserverbesturingselementen die zijn opgenomen in het DataControlField object. (Overgenomen van DataControlField)
DataTextField	Hiermee haalt u de naam op van het gegevensveld waarvoor de waarde is gebonden aan de Text eigenschap van het Button besturingselement dat door het ButtonField object wordt weergegeven.
DataTextFormatString	Hiermee wordt de tekenreeks opgehaald of ingesteld waarmee de weergave-indeling voor de waarde van het veld wordt opgegeven.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een gegevensbeheerveld momenteel wordt weergegeven in een ontwerpomgeving. (Overgenomen van DataControlField)
FooterStyle	Hiermee haalt u de stijl van de voettekst van het gegevensbeheerveld op of stelt u deze in. (Overgenomen van DataControlField)
FooterText	Hiermee haalt u de tekst op die wordt weergegeven in het voettekstitem van een gegevensbeheerveld of stelt u deze in. (Overgenomen van DataControlField)
HeaderImageUrl	Hiermee wordt de URL opgehaald of ingesteld van een afbeelding die wordt weergegeven in het koptekstitem van een gegevensbeheerveld. (Overgenomen van DataControlField)
HeaderStyle	Hiermee haalt u de stijl van de koptekst van het gegevensbeheerveld op of stelt u deze in. (Overgenomen van DataControlField)
HeaderText	Hiermee haalt u de tekst op die wordt weergegeven in het koptekstitem van een gegevensbeheerveld of stelt u deze in. (Overgenomen van DataControlField)
ImageUrl	Hiermee wordt de afbeelding opgehaald of ingesteld om voor elke knop in het ButtonField object weer te geven.
InsertVisible	Hiermee wordt een waarde opgehaald die aangeeft of het object zichtbaar is wanneer het DataControlField bovenliggende besturingselement voor gegevens in de invoegmodus staat. (Overgenomen van DataControlField)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het DataControlField object wijzigingen opslaat in de weergavestatus. (Overgenomen van DataControlField)
ItemStyle	Hiermee haalt u de stijl op van tekstgebaseerde inhoud die wordt weergegeven door een gegevensbesturingselementveld. (Overgenomen van DataControlField)
ShowHeader	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de koptekstsectie wordt weergegeven in een ButtonFieldBase object. (Overgenomen van ButtonFieldBase)
SortExpression	Hiermee haalt u een sorteerexpressie op die wordt gebruikt door een besturingselement voor gegevensbronnen om gegevens te sorteren. (Overgenomen van DataControlField)
Text	Hiermee wordt het statische bijschrift opgehaald of ingesteld dat voor elke knop in het ButtonField object wordt weergegeven.
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer valideert. (Overgenomen van DataControlField)
ValidationGroup	Hiermee wordt de naam van de groep validatiebesturingselementen opgehaald of ingesteld om te valideren wanneer op een knop in een ButtonFieldBase object wordt geklikt. (Overgenomen van ButtonFieldBase)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een DataControlField object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een gegevensbeheerveld wordt weergegeven. (Overgenomen van DataControlField)

Methoden

Name	Description
CloneField()	Hiermee maakt u een dubbele kopie van het huidige DataControlField-afgeleide object. (Overgenomen van DataControlField)
CopyProperties(DataControlField)	Kopieert de eigenschappen van het huidige ButtonField object naar het opgegeven DataControlField object.
CreateField()	Hiermee maakt en retourneert u een nieuw exemplaar van de ButtonField klasse.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extraheert de waarde van het gegevensbeheerveld uit de huidige tabelcel en voegt de waarde toe aan de opgegeven IDictionary verzameling. (Overgenomen van DataControlField)
FormatDataTextValue(Object)	Hiermee wordt de opgegeven veldwaarde voor een cel in het ButtonField object opgemaakt.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Initialize(Boolean, Control)	Initialiseert het huidige ButtonField object.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialiseert het opgegeven DataControlFieldCell object naar de opgegeven rijstatus.
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van DataControlField)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnFieldChanged()	Hiermee wordt de `FieldChanged` gebeurtenis gegenereerd. (Overgenomen van DataControlField)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de DataControlField weergavestatus sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van DataControlField)
ToString()	Retourneert een tekenreeks die dit DataControlField object vertegenwoordigt. (Overgenomen van DataControlField)
TrackViewState()	Hiermee zorgt u ervoor dat het DataControlField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)
ValidateSupportsCallback()	Bepaalt of de besturingselementen in een ButtonField object callbacks ondersteunen.

Expliciete interface-implementaties

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Hiermee wordt het schema opgehaald of ingesteld dat aan dit DataControlField object is gekoppeld. (Overgenomen van DataControlField)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het DataControlField object wijzigingen opslaat in de weergavestatus. (Overgenomen van DataControlField)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van het gegevensbeheerveld. (Overgenomen van DataControlField)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen opgeslagen die zijn aangebracht in de DataControlField weergavestatus sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van DataControlField)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat het DataControlField object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het besturingselement en kunnen worden opgeslagen in aanvragen voor dezelfde pagina. (Overgenomen van DataControlField)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?