ButtonField Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar ett fält som visas som en knapp i en databunden kontroll.

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

Arv: Object

DataControlField

ButtonFieldBase
ButtonField

Exempel

Följande kodexempel visar hur du använder ett ButtonField objekt för att visa en kolumn med kommandoknappar i en GridView kontroll.


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

Kommentarer

Klassen ButtonField används av databundna kontroller (till exempel GridView och DetailsView) för att visa en knapp för varje post som visas. Objektet ButtonField visas på olika sätt beroende på den databundna kontroll som det används i. Kontrollen visar till exempel GridView ett ButtonField objekt som en kolumn, medan DetailsView kontrollen visar det som en rad.

Om du klickar på en knapp i ett knappfält genereras kommandohändelsen för den överordnade databundna kontrollen. Du kan ange en anpassad rutin att utföra när en kommandoknapp klickas genom att tillhandahålla en händelsehanterare för kommandohändelsen.

Note

Kontrollen GridView genererar RowCommand händelsen, medan DetailsView kontrollen genererar händelsen ItemCommand .

Om du vill fastställa indexet för den post som genererar kommandohändelsen använder du CommandArgument egenskapen för det händelseargument som skickas till kommandohändelsen för den databundna kontrollen. Klassen ButtonField fyller automatiskt i CommandArgument egenskapen med lämpligt indexvärde.

Om du vill ange vilken typ av knapp som ska visas använder du egenskapen ButtonType . När du visar en länk eller kommandoknapp använder du Text egenskapen för att ange bildtexten som ska visas i knapparna.

Note

Om du anger egenskapen Text delar alla knappar i samma ButtonField undertext.

Du kan också binda objektet ButtonField till ett fält i en datakälla. På så sätt kan du visa olika bildtexter för knapparna ButtonField i objektet. De värden som finns i det angivna fältet används för knapparnas textrubriker. Ange egenskapen DataTextField för att binda ett ButtonField objekt till ett fält i en datakälla.

När du visar en bildknapp använder du ImageUrl egenskapen för att ange vilken bild som ska visas för knapparna ButtonField i objektet.

Note

Alla knappar i ett ButtonField objekt delar samma bild.

Du kan dölja ett ButtonField objekt i en databunden kontroll genom att ange Visible egenskapen till false.

Med ButtonField objektet kan du anpassa dess sidhuvud- och sidfotsavsnitt. Om du vill visa en bildtext i sidhuvud- eller sidfotsavsnittet HeaderText FooterText anger du respektive egenskaper. I stället för att visa text i rubrikavsnittet kan du visa en bild genom att ange egenskapen HeaderImageUrl . Om du vill dölja rubrikavsnittet i ett ButtonField objekt anger du egenskapen ShowHeader till false.

Note

Vissa databundna kontroller (till exempel GridView kontrollen) kan bara visa eller dölja hela rubrikavsnittet i kontrollen. Dessa databundna kontroller stöder inte egenskapen ShowHeader för ett enskilt knappfält. Om du vill visa eller dölja hela rubrikavsnittet i en databunden kontroll (om det är tillgängligt) använder du ShowHeader egenskapen för kontrollen.

Du kan också anpassa objektets ButtonField utseende (teckenfärg, bakgrundsfärg och så vidare) genom att ange formategenskaperna för de olika delarna av fältet. I följande tabell visas de olika stilegenskaperna.

Formategenskap	Formatinställningarna för
ControlStyle	De underordnade webbserverkontrollerna för ButtonField.
FooterStyle	Sidfotsavsnittet i ButtonField.
HeaderStyle	Rubrikavsnittet i ButtonField.
ItemStyle	Dataobjekten ButtonFieldi .

Konstruktorer

Name	Description
ButtonField()	Initierar en ny instans av ButtonField klassen.

Egenskaper

Name	Description
AccessibleHeaderText	Hämtar eller anger text som återges som egenskapsvärdet `AbbreviatedText` i vissa kontroller. (Ärvd från DataControlField)
ButtonType	Hämtar eller anger knapptypen som ska visas i knappfältet. (Ärvd från ButtonFieldBase)
CausesValidation	Hämtar eller anger ett värde som anger om verifieringen utförs när en knapp i ett ButtonFieldBase objekt klickas. (Ärvd från ButtonFieldBase)
CommandName	Hämtar eller anger en sträng som representerar den åtgärd som ska utföras när en knapp i ett ButtonField objekt klickas.
Control	Hämtar en referens till den datakontroll som DataControlField objektet är associerat med. (Ärvd från DataControlField)
ControlStyle	Hämtar formatet för alla webbserverkontroller som ingår i DataControlField objektet. (Ärvd från DataControlField)
DataTextField	Hämtar eller anger namnet på det datafält som värdet är bundet till Text egenskapen för kontrollen Button som återges av ButtonField objektet.
DataTextFormatString	Hämtar eller anger strängen som anger visningsformatet för fältets värde.
DesignMode	Hämtar ett värde som anger om ett datakontrollfält för närvarande visas i en designtidsmiljö. (Ärvd från DataControlField)
FooterStyle	Hämtar eller anger formatet för sidfoten för datakontrollfältet. (Ärvd från DataControlField)
FooterText	Hämtar eller anger texten som visas i sidfotsobjektet i ett datakontrollfält. (Ärvd från DataControlField)
HeaderImageUrl	Hämtar eller anger URL:en för en bild som visas i rubrikobjektet i ett datakontrollfält. (Ärvd från DataControlField)
HeaderStyle	Hämtar eller anger formatet för huvudet i datakontrollfältet. (Ärvd från DataControlField)
HeaderText	Hämtar eller anger den text som visas i rubrikobjektet i ett datakontrollfält. (Ärvd från DataControlField)
ImageUrl	Hämtar eller ställer in bilden som ska visas för varje knapp i ButtonField objektet.
InsertVisible	Hämtar ett värde som anger om DataControlField objektet är synligt när dess överordnade databundna kontroll är i infogningsläge. (Ärvd från DataControlField)
IsTrackingViewState	Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet. (Ärvd från DataControlField)
ItemStyle	Hämtar formatmallen för textbaserat innehåll som visas av ett datakontrollfält. (Ärvd från DataControlField)
ShowHeader	Hämtar eller anger ett värde som anger om rubrikavsnittet visas i ett ButtonFieldBase objekt. (Ärvd från ButtonFieldBase)
SortExpression	Hämtar eller anger ett sorteringsuttryck som används av en datakällakontroll för att sortera data. (Ärvd från DataControlField)
Text	Hämtar eller anger den statiska undertext som visas för varje knapp i ButtonField objektet.
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen validerar klientindata. (Ärvd från DataControlField)
ValidationGroup	Hämtar eller anger namnet på gruppen med verifieringskontroller för att verifiera när en knapp i ett ButtonFieldBase objekt klickas. (Ärvd från ButtonFieldBase)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett DataControlField objekt över flera begäranden för samma sida. (Ärvd från DataControlField)
Visible	Hämtar eller anger ett värde som anger om ett datakontrollfält återges. (Ärvd från DataControlField)

Metoder

Name	Description
CloneField()	Skapar en duplicerad kopia av det aktuella DataControlField-härledda objektet. (Ärvd från DataControlField)
CopyProperties(DataControlField)	Kopierar egenskaperna för det aktuella ButtonField objektet till det angivna DataControlField objektet.
CreateField()	Skapar och returnerar en ny instans av ButtonField klassen.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extraherar värdet för datakontrollfältet från den aktuella tabellcellen och lägger till värdet i den angivna IDictionary samlingen. (Ärvd från DataControlField)
FormatDataTextValue(Object)	Formaterar det angivna fältvärdet för en cell i ButtonField objektet.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
Initialize(Boolean, Control)	Initierar det aktuella ButtonField objektet.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initierar det angivna DataControlFieldCell objektet till det angivna radtillståndet.
LoadViewState(Object)	Återställer datakällans tidigare sparade vytillstånd. (Ärvd från DataControlField)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnFieldChanged()	Genererar händelsen `FieldChanged` . (Ärvd från DataControlField)
SaveViewState()	Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från DataControlField)
ToString()	Returnerar en sträng som representerar det här DataControlField objektet. (Ärvd från DataControlField)
TrackViewState()	DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida. (Ärvd från DataControlField)
ValidateSupportsCallback()	Avgör om kontrollerna som finns i ett ButtonField objekt stöder återanrop.

Explicita gränssnittsimplementeringar

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Hämtar eller anger schemat som är associerat med det här DataControlField objektet. (Ärvd från DataControlField)
IStateManager.IsTrackingViewState	Hämtar ett värde som anger om DataControlField objektet sparar ändringar i visningstillståndet. (Ärvd från DataControlField)
IStateManager.LoadViewState(Object)	Återställer datakontrollfältets tidigare sparade visningstillstånd. (Ärvd från DataControlField)
IStateManager.SaveViewState()	Sparar de ändringar som gjorts i visningstillståndet DataControlField sedan den tid då sidan publicerades tillbaka till servern. (Ärvd från DataControlField)
IStateManager.TrackViewState()	DataControlField Gör att objektet spårar ändringar i visningstillståndet så att de kan lagras i kontrollens ViewState egenskap och sparas mellan begäranden för samma sida. (Ärvd från DataControlField)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?