CommandField Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Representerar ett särskilt fält som visar kommandoknappar för att utföra markering, redigering, infogning eller borttagning av åtgärder i en databunden kontroll.

public ref class CommandField : System::Web::UI::WebControls::ButtonFieldBase
public class CommandField : System.Web.UI.WebControls.ButtonFieldBase
type CommandField = class
    inherit ButtonFieldBase
Public Class CommandField
Inherits ButtonFieldBase
Arv
Object
DataControlField
ButtonFieldBase
CommandField

Exempel

Följande kodexempel visar hur du använder ett CommandField fält för att visa kontroller för att redigera en post 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">
<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>


<%@ Page language="VB" %>

<!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>

Följande kodexempel visar hur du använder CancelTextegenskaperna , EditTextoch UpdateText för att anpassa texten för redigeringskontrollerna.


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


<%@ Page language="VB" %>

<!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>

Kommentarer

Klassen CommandField är ett särskilt fält som används av databundna kontroller (till exempel GridView och DetailsView) för att visa kommandoknappar som utför åtgärder för att ta bort, redigera, infoga eller välja. Kommandoknapparna för att utföra dessa åtgärder kan visas eller döljas med hjälp av de egenskaper som visas i följande tabell.

Fastighet Description
ShowDeleteButton Visar eller döljer knappen Ta bort i ett CommandField fält för varje post i den databundna kontrollen. Med knappen Ta bort kan användaren ta bort en post från datakällan.
ShowEditButton Visar eller döljer en redigera-knapp i ett CommandField fält för varje post i den databundna kontrollen. Med knappen Redigera kan användaren redigera en post från datakällan. När användaren klickar på knappen Redigera för en specifik post ersätts knappen Redigera med en uppdateringsknapp och knappen Avbryt. Alla andra kommandoknappar är också dolda.
ShowInsertButton Visar eller döljer knappen Ny i ett CommandField fält. Med knappen Nytt kan användaren infoga en ny post i datakällan. När användaren klickar på knappen Ny ersätts den med knappen Infoga och knappen Avbryt. Alla andra kommandoknappar är också dolda. Observera: Den här egenskapen gäller endast för databundna kontroller som stöder infogningsåtgärder, till exempel DetailsView kontrollen.
ShowSelectButton Visar eller döljer knappen Välj i ett CommandField fält för varje post i den databundna kontrollen. Med knappen Välj kan användaren välja en post i den databundna kontrollen.

Dessutom kan knappen Avbryt som visas när en post är i redigerings- eller infogningsläge visas eller döljas genom att egenskapen anges ShowCancelButton .

Note

När en databunden kontroll används i kombination med en datakällakontroll (till exempel en SqlDataSource kontroll) kan den databundna kontrollen dra nytta av datakällans funktioner och tillhandahålla funktioner för automatisk borttagning, uppdatering och infogning. För andra datakällor måste du ange rutinerna för att utföra dessa åtgärder under lämpliga händelser för den databundna kontrollen.

Fältet CommandField visas på olika sätt beroende på vilken databunden kontroll som det används i. Kontrollen visar till exempel GridView ett CommandField fält som en kolumn, medan DetailsView kontrollen visar det som en rad.

Om du vill ange vilken typ av knapp som ska visas använder du egenskapen ButtonType . När egenskapen ButtonType är inställd på ButtonType.Button eller ButtonType.Linkkan du ange vilken text som ska visas för knapparna genom att ange egenskaperna som visas i följande tabell.

Fastighet Description
CancelText Bildtexten för knappen Avbryt.
DeleteText Bildtexten för knappen Ta bort.
EditText Bildtexten för knappen Redigera.
InsertText Bildtexten för knappen Infoga. Observera: Den här egenskapen gäller endast för databundna kontroller som stöder infogningsåtgärder, till exempel DetailsView kontrollen.
NewText Bildtexten för knappen Nytt. Observera: Den här egenskapen gäller endast för databundna kontroller som stöder infogningsåtgärder, till exempel DetailsView kontrollen.
SelectText Bildtexten för knappen Välj.
UpdateText Undertexten för knappen Uppdatera.

I stället för att visa en kommandoknapp eller en länkknapp kan du visa en bildknapp genom att ange ButtonType egenskapen till ButtonType.Image och sedan ange egenskaperna som visas i följande tabell.

Fastighet Description
CancelImageUrl Bilden som ska visas för knappen Avbryt
DeleteImageUrl Bilden som ska visas för knappen Ta bort.
EditImageUrl Bilden som ska visas för knappen Redigera.
InsertText Bilden som ska visas för knappen Infoga. Observera: Den här egenskapen gäller endast för databundna kontroller som stöder infogningsåtgärder, till exempel DetailsView kontrollen.
NewImageUrl Bilden som ska visas för knappen Nytt. Observera: Den här egenskapen gäller endast för databundna kontroller som stöder infogningsåtgärder, till exempel DetailsView kontrollen.
SelectImageUrl Bilden som ska visas för knappen Välj.
UpdateImageUrl Bilden som ska visas för knappen Uppdatera.

När användaren klickar på en knapp i ett CommandField fält utförs som standard verifiering på alla verifieringskontroller på sidan. Om du vill förhindra verifiering när en knapp klickas anger du CausesValidation egenskapen till false.

Du kan dölja ett CommandField fält i en databunden kontroll genom att ange Visible egenskapen till false.

Med CommandField fältet kan du anpassa dess sidhuvud- och sidfotsavsnitt. Om du vill visa en bildtext i sidhuvudet eller sidfotsavsnittet anger du HeaderText egenskapen eller FooterText . 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 CommandField 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 kontrollens ShowHeader egenskap.

Du kan också anpassa objektets CommandField 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 Description
ControlStyle Formatinställningarna för de underordnade webbserverkontrollerna för CommandField objektet.
FooterStyle Formatinställningarna för sidfotsavsnittet i CommandField objektet.
HeaderStyle Formatinställningarna för rubrikavsnittet i CommandField objektet.
ItemStyle Formatinställningarna för dataobjekten CommandField i objektet.

Konstruktorer

Name Description
CommandField()

Initierar en ny instans av CommandField 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)
CancelImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Avbryt i ett CommandField fält.
CancelText

Hämtar eller anger bildtexten för knappen Avbryt som visas i ett CommandField fält.
CausesValidation

Hämtar eller anger ett värde som anger om verifieringen utförs när användaren klickar på en knapp i ett CommandField fält.
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)
DeleteImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Ta bort i ett CommandField fält.
DeleteText

Hämtar eller anger bildtexten för knappen Ta bort i ett CommandField fält.
DesignMode

Hämtar ett värde som anger om ett datakontrollfält för närvarande visas i en designtidsmiljö.

(Ärvd från DataControlField)
EditImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Redigera i ett CommandField fält.
EditText

Hämtar eller anger bildtexten för knappen Redigera i ett CommandField fält.
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)
InsertImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Infoga i ett CommandField fält.
InsertText

Hämtar eller anger bildtexten för knappen Infoga i ett CommandField fält.
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)
NewImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Ny i ett CommandField fält.
NewText

Hämtar eller anger bildtexten för knappen Ny i ett CommandField fält.
SelectImageUrl

Hämtar eller anger URL:en till en bild som ska visas för knappen Välj i ett CommandField fält.
SelectText

Hämtar eller anger bildtexten för knappen Välj i ett CommandField fält.
ShowCancelButton

Hämtar eller anger ett värde som anger om knappen Avbryt visas i ett CommandField fält.
ShowDeleteButton

Hämtar eller anger ett värde som anger om knappen Ta bort visas i ett CommandField fält.
ShowEditButton

Hämtar eller anger ett värde som anger om knappen Redigera visas i ett CommandField fält.
ShowHeader

Hämtar eller anger ett värde som anger om rubrikavsnittet visas i ett ButtonFieldBase objekt.

(Ärvd från ButtonFieldBase)
ShowInsertButton

Hämtar eller anger ett värde som anger om en ny knapp visas i ett CommandField fält.
ShowSelectButton

Hämtar eller anger ett värde som anger om en Välj-knapp visas i ett CommandField fält.
SortExpression

Hämtar eller anger ett sorteringsuttryck som används av en datakällakontroll för att sortera data.

(Ärvd från DataControlField)
UpdateImageUrl

Hämtar eller anger URL:en till en bild som ska visas för en uppdateringsknapp i ett CommandField fält.
UpdateText

Hämtar eller anger undertexten för en uppdateringsknapp i ett CommandField fält.
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 CommandField objektet till det angivna DataControlField objektet.
CreateField()

Skapar ett tomt CommandField objekt.
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)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
Initialize(Boolean, Control)

Utför grundläggande instansinitiering för ett datakontrollfält.

(Ärvd från DataControlField)
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 i ett CommandField 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