ButtonColumn Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Tipo di colonna per il DataGrid controllo 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

Usare la ButtonColumn classe in un DataGrid controllo per creare un pulsante corrispondente a ogni riga nel 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 la stessa 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 la didascalia di testo. 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 nell'oggetto ButtonColumn viene generato l'evento ItemCommand . È possibile controllare a livello di codice l'azione eseguita 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

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

Proprietà

Nome	Descrizione
ButtonType	Ottiene o imposta il tipo di pulsante da visualizzare nell'oggetto ButtonColumn .
CausesValidation	Ottiene o imposta un valore che indica se viene eseguita la convalida quando si fa clic su un pulsante nell'oggetto ButtonColumn .
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 da un'origine dati da associare all'oggetto ButtonColumn .
DataTextFormatString	Ottiene o imposta la stringa che specifica il formato di visualizzazione per la didascalia in ogni 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 piè di pagina della colonna. (Ereditato da DataGridColumn)
FooterText	Ottiene o imposta il testo visualizzato nella sezione piè di pagina della colonna. (Ereditato da DataGridColumn)
HeaderImageUrl	Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione intestazione della colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene le proprietà di stile per la sezione intestazione della colonna. (Ereditato da DataGridColumn)
HeaderText	Ottiene o imposta il testo visualizzato nella sezione intestazione della colonna. (Ereditato da DataGridColumn)
IsTrackingViewState	Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per salvare il relativo stato. (Ereditato da DataGridColumn)
ItemStyle	Ottiene le proprietà di stile per le celle dell'elemento della colonna. (Ereditato da DataGridColumn)
Owner	Ottiene il DataGrid controllo di cui la colonna è membro. (Ereditato da DataGridColumn)
SortExpression	Ottiene o imposta il nome del campo o dell'espressione da passare al OnSortCommand(DataGridSortCommandEventArgs) metodo quando viene selezionata una colonna 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 cui l'oggetto ButtonColumn causa la convalida quando esegue il postback al server.
ViewState	Ottiene l'oggetto StateBag che consente a una colonna derivata dalla DataGridColumn classe di archiviarne le proprietà. (Ereditato da DataGridColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile nel DataGrid controllo . (Ereditato da DataGridColumn)

Metodi

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

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IStateManager.IsTrackingViewState	Ottiene un valore che indica se la colonna sta tenendo traccia delle 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 modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia il rilevamento delle modifiche dello stato. (Ereditato da DataGridColumn)

Vedi anche

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