CommandField Classe

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 utilizzare un CommandField campo per visualizzare i controlli per modificare un 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 a 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à illustrate nella tabella seguente.

Proprietà	Descrizione
ShowDeleteButton	Mostra 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. Vengono nascosti anche tutti gli altri pulsanti di comando.
ShowInsertButton	Visualizza 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. Vengono nascosti anche tutti gli altri pulsanti di comando. Nota: Questa proprietà si applica solo ai controlli associati a dati che supportano operazioni di inserimento, ad esempio il DetailsView controllo .
ShowSelectButton	Visualizza o nasconde un pulsante Seleziona in un CommandField campo per ogni record nel controllo associato a dati. Il pulsante Seleziona consente all'utente di selezionare un record nel controllo associato a dati.

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

Annotazioni

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à di eliminazione, aggiornamento e inserimento automatiche. Per altre origini dati, è necessario fornire le routine per eseguire queste operazioni durante gli eventi appropriati per il controllo associato a dati.

Il CommandField campo viene visualizzato in modo diverso a seconda del controllo associato a dati in cui viene utilizzato. 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, utilizzare 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à illustrate 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 impedire l'esecuzione della 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 FooterText proprietà o . Anziché visualizzare il testo nella sezione 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.

Annotazioni

Alcuni controlli associati a dati,ad esempio il GridView controllo, possono mostrare 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 intestazione dell'oggetto CommandField .
ItemStyle	Impostazioni di stile per gli elementi di dati nell'oggetto CommandField .

Costruttori

Nome	Descrizione
CommandField()	Inizializza una nuova istanza della classe CommandField.

Proprietà

Nome	Descrizione
AccessibleHeaderText	Ottiene o imposta il testo di cui viene eseguito il rendering come valore della `AbbreviatedText` proprietà in alcuni controlli. (Ereditato da DataControlField)
ButtonType	Ottiene o imposta il tipo di pulsante da visualizzare nel campo del pulsante. (Ereditato da ButtonFieldBase)
CancelImageUrl	Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Annulla in un CommandField campo.
CancelText	Ottiene o imposta la didascalia per il pulsante Annulla visualizzato in un CommandField campo.
CausesValidation	Ottiene o imposta un valore che indica se la convalida viene eseguita quando l'utente fa clic su un pulsante in un CommandField campo.
Control	Ottiene un riferimento al controllo dati a cui è associato l'oggetto DataControlField . (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 un pulsante Elimina in un CommandField campo.
DeleteText	Ottiene o imposta la didascalia di un pulsante Elimina in un CommandField campo.
DesignMode	Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente in fase di progettazione. (Ereditato da DataControlField)
EditImageUrl	Ottiene o imposta l'URL di un'immagine da visualizzare per un pulsante Modifica in un CommandField campo.
EditText	Ottiene o imposta la didascalia di un pulsante Modifica in un CommandField campo.
FooterStyle	Ottiene o imposta lo stile del piè di pagina del campo del controllo dati. (Ereditato da DataControlField)
FooterText	Ottiene o imposta il testo visualizzato nell'elemento piè di pagina di un campo del controllo dati. (Ereditato da DataControlField)
HeaderImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata nell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
HeaderStyle	Ottiene o imposta lo stile dell'intestazione del campo del controllo dati. (Ereditato da DataControlField)
HeaderText	Ottiene o imposta il testo visualizzato nell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField)
InsertImageUrl	Ottiene o imposta l'URL di un'immagine da visualizzare per il pulsante Inserisci in un CommandField campo.
InsertText	Ottiene o imposta la didascalia per il pulsante Inserisci in un CommandField campo.
InsertVisible	Ottiene un valore che indica se l'oggetto è visibile quando il DataControlField controllo associato a dati padre è in modalità di inserimento. (Ereditato da DataControlField)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
ItemStyle	Ottiene lo stile di qualsiasi contenuto basato su testo visualizzato 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 CommandField campo.
NewText	Ottiene o imposta la didascalia per il pulsante Nuovo in un CommandField campo.
SelectImageUrl	Ottiene o imposta l'URL di un'immagine da visualizzare per un pulsante Seleziona in un CommandField campo.
SelectText	Ottiene o imposta la didascalia di un pulsante Seleziona in un CommandField campo.
ShowCancelButton	Ottiene o imposta un valore che indica se un pulsante Annulla viene visualizzato in un CommandField campo.
ShowDeleteButton	Ottiene o imposta un valore che indica se un pulsante Elimina viene visualizzato in un CommandField campo.
ShowEditButton	Ottiene o imposta un valore che indica se un pulsante Modifica viene visualizzato in un CommandField campo.
ShowHeader	Ottiene o imposta un valore che indica se la sezione dell'intestazione viene visualizzata in un ButtonFieldBase oggetto . (Ereditato da ButtonFieldBase)
ShowInsertButton	Ottiene o imposta un valore che indica se un pulsante Nuovo viene visualizzato in un CommandField campo.
ShowSelectButton	Ottiene o imposta un valore che indica se un pulsante Seleziona viene visualizzato in un CommandField campo.
SortExpression	Ottiene o imposta un'espressione di ordinamento 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 CommandField campo.
UpdateText	Ottiene o imposta la didascalia di un pulsante Aggiorna in un CommandField campo.
ValidateRequestMode	Ottiene o imposta un valore che specifica se il controllo convalida l'input 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 ButtonFieldBase oggetto . (Ereditato da ButtonFieldBase)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataControlField oggetto in 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

Nome	Descrizione
CloneField()	Crea una copia duplicata dell'oggetto derivato da corrente DataControlField. (Ereditato da DataControlField)
CopyProperties(DataControlField)	Copia le proprietà dell'oggetto corrente CommandField nell'oggetto specificato DataControlField .
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 del controllo dati dalla cella della tabella corrente e aggiunge il valore alla raccolta specificata IDictionary . (Ereditato da DataControlField)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Initialize(Boolean, Control)	Esegue l'inizializzazione di istanza di base per un campo di controllo dati. (Ereditato da DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inizializza l'oggetto specificato DataControlFieldCell nello stato di riga specificato.
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da DataControlField)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnFieldChanged()	Genera l'evento `FieldChanged`. (Ereditato da DataControlField)
SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
ToString()	Restituisce una stringa che rappresenta questo DataControlField oggetto. (Ereditato da DataControlField)
TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)
ValidateSupportsCallback()	Determina se i controlli contenuti in un CommandField oggetto supportano i callback.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ottiene o imposta lo schema associato a questo DataControlField oggetto. (Ereditato da DataControlField)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvato in precedenza del campo del controllo dati. (Ereditato da DataControlField)
IStateManager.SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
IStateManager.TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?