CommandField Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Rappresenta un campo speciale che visualizza i pulsanti di comando per eseguire operazioni di selezione, modifica, inserimento o eliminazione in un controllo associato a dati.

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
Ereditarietà
Object
DataControlField
ButtonFieldBase
CommandField

Esempio

Nell'esempio di codice seguente viene illustrato come usare un campo per visualizzare i controlli per modificare un CommandField record in un GridView controllo.


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

Nell'esempio di codice seguente viene illustrato come usare le CancelTextproprietà , EditTexte UpdateText per personalizzare il testo per i controlli di modifica.


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

Commenti

La CommandField classe è un campo speciale usato dai controlli associati ai dati (ad esempio GridView e DetailsView) per visualizzare i pulsanti di comando che eseguono operazioni di eliminazione, modifica, inserimento o selezione. I pulsanti di comando per eseguire queste operazioni possono essere visualizzati o nascosti usando le proprietà visualizzate nella tabella seguente.

Proprietà Descrizione
ShowDeleteButton Visualizza o nasconde un pulsante Elimina in un CommandField campo per ogni record nel controllo associato a dati. Il pulsante Elimina consente all'utente di eliminare un record dall'origine dati.
ShowEditButton Mostra o nasconde un pulsante Modifica in un CommandField campo per ogni record nel controllo associato a dati. Il pulsante Modifica consente all'utente di modificare un record dall'origine dati. Quando l'utente fa clic sul pulsante Modifica per un record specifico, il pulsante Modifica viene sostituito con un pulsante Aggiorna e un pulsante Annulla. Tutti gli altri pulsanti di comando sono nascosti.
ShowInsertButton Mostra o nasconde il pulsante Nuovo in un CommandField campo. Il pulsante Nuovo consente all'utente di inserire un nuovo record nell'origine dati. Quando l'utente fa clic sul pulsante Nuovo, viene sostituito con un pulsante Inserisci e un pulsante Annulla. Tutti gli altri pulsanti di comando sono nascosti. Nota: Questa proprietà si applica solo ai controlli associati ai dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo.
ShowSelectButton Mostra o nasconde un pulsante Select in un CommandField campo per ogni record nel controllo associato a dati. Il pulsante Select consente all'utente di selezionare un record nel controllo associato ai dati.

Inoltre, il pulsante Annulla visualizzato quando un record è in modalità di modifica o inserimento può essere visualizzato o nascosto impostando la ShowCancelButton proprietà.

Nota

Quando un controllo associato a dati viene usato in combinazione con un controllo origine dati (ad esempio un SqlDataSource controllo), il controllo associato a dati può sfruttare le funzionalità del controllo origine dati e fornire funzionalità automatiche di eliminazione, aggiornamento e inserimento. Per altre origini dati, è necessario fornire le routine per eseguire queste operazioni durante gli eventi appropriati per il controllo associato ai dati.

Il CommandField campo viene visualizzato in modo diverso a seconda del controllo associato ai dati in cui viene usato. Ad esempio, il GridView controllo visualizza un CommandField campo come colonna, mentre il DetailsView controllo lo visualizza come riga.

Per specificare il tipo di pulsante da visualizzare, usare la ButtonType proprietà . Quando la ButtonType proprietà è impostata su ButtonType.Button o ButtonType.Link, è possibile specificare il testo da visualizzare per i pulsanti impostando le proprietà visualizzate nella tabella seguente.

Proprietà Descrizione
CancelText Didascalia per il pulsante Annulla.
DeleteText Didascalia per il pulsante Elimina.
EditText Didascalia per il pulsante Modifica.
InsertText Didascalia per il pulsante Inserisci. Nota: Questa proprietà si applica solo ai controlli associati a dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo .
NewText Didascalia per il pulsante Nuovo. Nota: Questa proprietà si applica solo ai controlli associati a dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo .
SelectText Didascalia per il pulsante Seleziona.
UpdateText Didascalia per il pulsante Aggiorna.

Anziché visualizzare un pulsante di comando o un pulsante di collegamento, è possibile visualizzare un pulsante immagine impostando la ButtonType proprietà su ButtonType.Image e quindi impostando le proprietà illustrate nella tabella seguente.

Proprietà Descrizione
CancelImageUrl Immagine da visualizzare per il pulsante Annulla
DeleteImageUrl Immagine da visualizzare per il pulsante Elimina.
EditImageUrl Immagine da visualizzare per il pulsante Modifica.
InsertText Immagine da visualizzare per il pulsante Inserisci. Nota: Questa proprietà si applica solo ai controlli associati a dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo .
NewImageUrl Immagine da visualizzare per il pulsante Nuovo. Nota: Questa proprietà si applica solo ai controlli associati a dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo .
SelectImageUrl Immagine da visualizzare per il pulsante Seleziona.
UpdateImageUrl Immagine da visualizzare per il pulsante Aggiorna.

Per impostazione predefinita, quando l'utente fa clic su un pulsante in un CommandField campo, la convalida viene eseguita su tutti i controlli di convalida nella pagina. Per evitare che si verifichi la convalida quando si fa clic su un pulsante, impostare la CausesValidation proprietà su false.

È possibile nascondere un CommandField campo in un controllo associato a dati impostando la Visible proprietà su false.

Il CommandField campo consente di personalizzare le relative sezioni di intestazione e piè di pagina. Per visualizzare una didascalia nell'intestazione o nella sezione piè di pagina, impostare rispettivamente la HeaderText proprietà o FooterText . Anziché visualizzare il testo nella sezione dell'intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà . Per nascondere la sezione dell'intestazione in un CommandField oggetto, impostare la ShowHeader proprietà su false.

Nota

Alcuni controlli associati a dati , ad esempio il GridView controllo , possono visualizzare o nascondere solo l'intera sezione di intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo pulsante. Per visualizzare o nascondere l'intera sezione di intestazione di un controllo associato a dati (se disponibile), utilizzare la proprietà del ShowHeader controllo.

È anche possibile personalizzare l'aspetto dell'oggetto CommandField (colore del carattere, colore di sfondo e così via) impostando le proprietà di stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Proprietà Style Descrizione
ControlStyle Impostazioni di stile per i controlli server Web figlio dell'oggetto CommandField .
FooterStyle Impostazioni di stile per la sezione piè di pagina dell'oggetto CommandField .
HeaderStyle Impostazioni di stile per la sezione di intestazione dell'oggetto CommandField .
ItemStyle Impostazioni di stile per gli elementi di dati nell'oggetto CommandField .

Costruttori

CommandField()

Inizializza una nuova istanza della classe CommandField.

Proprietà

AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.

(Ereditato da DataControlField)
ButtonType

Ottiene o imposta il tipo di pulsante da visualizzare nel campo pulsante.

(Ereditato da ButtonFieldBase)
CancelImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Annulla in un campo CommandField.
CancelText

Ottiene o imposta la didascalia del pulsante Annulla visualizzato in un campo CommandField.
CausesValidation

Ottiene o imposta un valore che indica se quando l'utente fa clic su un pulsante in un campo CommandField viene eseguita la convalida.
Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.

(Ereditato da DataControlField)
ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.

(Ereditato da DataControlField)
DeleteImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Elimina in un campo CommandField.
DeleteText

Ottiene o imposta la didascalia per un pulsante Elimina in un campo CommandField.
DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.

(Ereditato da DataControlField)
EditImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per un pulsante Modifica in un campo CommandField.
EditText

Ottiene o imposta la didascalia per un pulsante Modifica in un campo CommandField.
FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
HeaderImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati.

(Ereditato da DataControlField)
HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.

(Ereditato da DataControlField)
HeaderText

Ottiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati.

(Ereditato da DataControlField)
InsertImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Inserisci in un campo CommandField.
InsertText

Ottiene o imposta la didascalia per il pulsante Inserisci in un campo CommandField.
InsertVisible

Ottiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento.

(Ereditato da DataControlField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.

(Ereditato da DataControlField)
NewImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Nuovo in un campo CommandField.
NewText

Ottiene o imposta la didascalia per il pulsante Nuovo in un campo CommandField.
SelectImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Seleziona in un campo CommandField.
SelectText

Ottiene o imposta la didascalia per un pulsante Seleziona in un campo CommandField.
ShowCancelButton

Ottiene o imposta un valore che indica se un pulsante Annulla viene visualizzato in un campo CommandField.
ShowDeleteButton

Ottiene o imposta un valore che indica se un pulsante Elimina viene visualizzato in un campo CommandField.
ShowEditButton

Ottiene o imposta un valore che indica se un pulsante Modifica viene visualizzato in un campo CommandField.
ShowHeader

Ottiene o imposta un valore che indica se la sezione di intestazione viene visualizzata in un oggetto ButtonFieldBase.

(Ereditato da ButtonFieldBase)
ShowInsertButton

Ottiene o imposta un valore che indica se un pulsante Nuovo viene visualizzato in un campo CommandField.
ShowSelectButton

Ottiene o imposta un valore che indica se un pulsante Seleziona viene visualizzato in un campo CommandField.
SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.

(Ereditato da DataControlField)
UpdateImageUrl

Ottiene o imposta l'URL di un'immagine da visualizzare per un pulsante Aggiorna in un campo CommandField.
UpdateText

Ottiene o imposta la didascalia per un pulsante Aggiorna in un campo CommandField.
ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.

(Ereditato da DataControlField)
ValidationGroup

Ottiene o imposta il nome del gruppo di controlli di convalida da convalidare quando si fa clic su un pulsante in un oggetto ButtonFieldBase.

(Ereditato da ButtonFieldBase)
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina.

(Ereditato da DataControlField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.

(Ereditato da DataControlField)

Metodi

CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.

(Ereditato da DataControlField)
CopyProperties(DataControlField)

Copia le proprietà dell'oggetto CommandField corrente nell'oggetto DataControlField specificato.
CreateField()

Crea un oggetto CommandField vuoto.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Estrae il valore del campo di controllo dati dalla cella corrente della tabella e aggiunge il valore all'insieme IDictionary specificato.

(Ereditato da DataControlField)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Initialize(Boolean, Control)

Esegue un'inizializzazione dell'istanza di base per un campo di controllo dati.

(Ereditato da DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inizializza l'oggetto DataControlFieldCell specificato nello stato della riga specificata.
LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.

(Ereditato da DataControlField)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnFieldChanged()

Genera l'evento FieldChanged.

(Ereditato da DataControlField)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.

(Ereditato da DataControlField)
TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)
ValidateSupportsCallback()

Determina se i controlli contenuti in un oggetto CommandField supportano i callback.

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.

(Ereditato da DataControlField)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.

(Ereditato da DataControlField)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
IStateManager.TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)

Si applica a

Vedi anche