ButtonColumn Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Tipo di colonna per il controllo DataGrid che contiene un pulsante definito dall'utente.

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn

public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn

type ButtonColumn = class
    inherit DataGridColumn

Public Class ButtonColumn
Inherits DataGridColumn

Ereditarietà

Object

DataGridColumn

ButtonColumn

Esempio

Nell'esempio di codice seguente viene illustrato come usare ButtonColumn la classe in un DataGrid controllo per creare pulsanti Add .

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}

Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

Commenti

Utilizzare la ButtonColumn classe in un DataGrid controllo per creare un pulsante che corrisponde a ogni riga del DataGrid controllo. Specificare la didascalia visualizzata nei pulsanti impostando la Text proprietà . Se si imposta la Text proprietà, tutti i pulsanti nell'oggetto ButtonColumn condividono lo stesso didascalia. In alternativa, è possibile associare i ButtonColumn pulsanti a un campo in un'origine dati. In questo modo è possibile visualizzare didascalie diverse per ogni pulsante. I valori nel campo specificato vengono utilizzati per il testo didascalia. Impostare la DataTextField proprietà per associare l'oggetto a un campo in un'origine ButtonColumn dati.

È possibile formattare le didascalie visualizzate nei pulsanti impostando la DataTextField proprietà con una stringa di formattazione.

Facendo clic sui pulsanti in ButtonColumn viene generato l'evento ItemCommand . È possibile controllare l'azione eseguita a livello di codice quando si fa clic sul pulsante fornendo un gestore eventi per l'evento ItemCommand .

Per impostazione predefinita, la convalida della pagina non viene eseguita quando si fa clic su un pulsante in ButtonColumn . La convalida della pagina determina se i controlli di input associati a un controllo di convalida nella pagina passano tutte le regole di convalida specificate dal controllo di convalida. Per eseguire la convalida della pagina quando si fa clic su un pulsante, impostare la CausesValidation proprietà su true.

Costruttori

ButtonColumn()

Inizializza una nuova istanza della classe ButtonColumn.

Proprietà

ButtonType	Ottiene o imposta il tipo di pulsante da visualizzare nell'oggetto ButtonColumn.
CausesValidation	Ottiene o imposta un valore che indica se quando si fa clic su un pulsante nell'oggetto ButtonColumn viene eseguita la convalida.
CommandName	Ottiene o imposta una stringa che rappresenta il comando da eseguire quando si fa clic su un pulsante nell'oggetto ButtonColumn.
DataTextField	Ottiene o imposta il nome del campo di un'origine dati da associare all'oggetto ButtonColumn.
DataTextFormatString	Ottiene o imposta la stringa che specifica il formato di visualizzazione per la didascalia di ciascun pulsante.
DesignMode	Ottiene un valore che indica se la colonna è in modalità progettazione. (Ereditato da DataGridColumn)
FooterStyle	Ottiene le proprietà di stile per la sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
FooterText	Ottiene o imposta il testo visualizzato nella sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
HeaderImageUrl	Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene le proprietà di stile per la sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderText	Ottiene o imposta il testo visualizzato nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
IsTrackingViewState	Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per il salvataggio dello stato. (Ereditato da DataGridColumn)
ItemStyle	Ottiene le proprietà di stile per le celle degli elementi della colonna. (Ereditato da DataGridColumn)
Owner	Ottiene il controllo DataGrid di cui la colonna è membro. (Ereditato da DataGridColumn)
SortExpression	Ottiene o imposta il nome del campo o l'espressione da passare al metodo OnSortCommand(DataGridSortCommandEventArgs) quando una colonna viene selezionata per l'ordinamento. (Ereditato da DataGridColumn)
Text	Ottiene o imposta la didascalia visualizzata nei pulsanti dell'oggetto ButtonColumn.
ValidationGroup	Ottiene o imposta il gruppo di controlli di convalida per il quale l'oggetto ButtonColumn causa la convalida in occasione del postback al server.
ViewState	Ottiene l'oggetto StateBag che consente a una colonna derivata dalla classe DataGridColumn di memorizzare le relative proprietà. (Ereditato da DataGridColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile nel controllo DataGrid. (Ereditato da DataGridColumn)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FormatDataTextValue(Object)	Converte il valore specificato nel formato indicato dalla proprietà DataTextFormatString.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Initialize()	Ripristina lo stato iniziale dell'oggetto ButtonColumn.
InitializeCell(TableCell, Int32, ListItemType)	Ripristina lo stato iniziale di una cella dell'oggetto ButtonColumn.
LoadViewState(Object)	Carica lo stato dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnColumnChanged()	Chiama il metodo OnColumnsChanged(). (Ereditato da DataGridColumn)
SaveViewState()	Salva lo stato corrente dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
ToString()	Restituisce la rappresentazione in forma di stringa della colonna. (Ereditato da DataGridColumn)
TrackViewState()	Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. (Ereditato da DataGridColumn)

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState	Ottiene un valore che indica se nella colonna vengono registrate le modifiche dello stato di visualizzazione. (Ereditato da DataGridColumn)
IStateManager.LoadViewState(Object)	Carica lo stato salvato in precedenza. (Ereditato da DataGridColumn)
IStateManager.SaveViewState()	Restituisce un oggetto contenente le modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia la registrazione delle modifiche dello stato. (Ereditato da DataGridColumn)

Vedi anche

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton