ButtonColumn ButtonColumn ButtonColumn ButtonColumn Class

Definizione

Tipo di colonna per il controllo DataGrid che contiene un pulsante definito dall'utente.A column type for the DataGrid control that contains a user-defined button.

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à

Esempi

Nell'esempio di codice riportato di seguito viene ButtonColumn illustrato come utilizzare DataGrid la classe in un controllo per creare pulsanti di aggiunta .The following code example demonstrates how to use ButtonColumn class in a DataGrid control to create Add buttons.

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 'Page_Init 

Commenti

Usare la ButtonColumn classe in un DataGrid controllo per creare un pulsante che corrisponde DataGrid a ogni riga nel controllo.Use the ButtonColumn class in a DataGrid control to create a button that corresponds with each row in the DataGrid control. Specificare la didascalia che viene visualizzata nei pulsanti impostando la Text proprietà.Specify the caption that is displayed in the buttons by setting the Text property. Se si imposta la Text proprietà, tutti i pulsanti ButtonColumn nell'oggetto condividono la stessa didascalia.If you set the Text property, all buttons in the ButtonColumn object share the same caption. In alternativa, è possibile associare i ButtonColumn pulsanti a un campo in un'origine dati.Alternatively, you can bind the ButtonColumn buttons to a field in a data source. In questo modo è possibile visualizzare didascalie diverse per ogni pulsante.This allows you to display different captions for each button. I valori nel campo specificato vengono usati per la didascalia di testo.The values in the specified field are used for the text caption. Impostare la DataTextField proprietà per associare l' ButtonColumn oggetto a un campo in un'origine dati.Set the DataTextField property to bind the ButtonColumn to a field in a data source.

È possibile formattare le didascalie visualizzate nei pulsanti impostando la DataTextField proprietà con una stringa di formattazione.You can format the captions that are displayed in the buttons by setting the DataTextField property with a formatting string.

Se si fa clic sui ButtonColumn pulsanti in ItemCommand , viene generato l'evento.Clicking the buttons in the ButtonColumn raises the ItemCommand event. È possibile controllare a livello di codice l'azione che viene eseguita quando si fa clic sul pulsante fornendo un gestore eventi per ItemCommand l'evento.You can programmatically control the action that is performed when the button is clicked by providing an event handler for the ItemCommand event.

Per impostazione predefinita, la convalida della pagina non viene eseguita quando si ButtonColumn fa clic su un pulsante nell'oggetto.By default, page validation is not performed when a button in the ButtonColumn is clicked. 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.Page validation determines whether the input controls that are associated with a validation control on the page all pass the validation rules that are specified by the validation control. Per eseguire la convalida della pagina quando si fa clic su un pulsante CausesValidation , impostare truela proprietà su.To perform page validation when a button is clicked, set the CausesValidation property to true.

Costruttori

ButtonColumn() ButtonColumn() ButtonColumn() ButtonColumn()

Inizializza una nuova istanza della classe ButtonColumn.Initializes a new instance of the ButtonColumn class.

Proprietà

ButtonType ButtonType ButtonType ButtonType

Ottiene o imposta il tipo di pulsante da visualizzare nell'oggetto ButtonColumn.Gets or sets the type of button to display in the ButtonColumn object.

CausesValidation CausesValidation CausesValidation CausesValidation

Ottiene o imposta un valore che indica se quando si fa clic su un pulsante nell'oggetto ButtonColumn viene eseguita la convalida.Gets or sets a value indicating whether validation is performed when a button in the ButtonColumn object is clicked.

CommandName CommandName CommandName CommandName

Ottiene o imposta una stringa che rappresenta il comando da eseguire quando si fa clic su un pulsante nell'oggetto ButtonColumn.Gets or sets a string that represents the command to perform when a button in the ButtonColumn object is clicked.

DataTextField DataTextField DataTextField DataTextField

Ottiene o imposta il nome del campo di un'origine dati da associare all'oggetto ButtonColumn.Gets or sets the field name from a data source to bind to the ButtonColumn object.

DataTextFormatString DataTextFormatString DataTextFormatString DataTextFormatString

Ottiene o imposta la stringa che specifica il formato di visualizzazione per la didascalia di ciascun pulsante.Gets or sets the string that specifies the display format for the caption in each button.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se la colonna è in modalità progettazione.Gets a value that indicates whether the column is in design mode.

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle FooterStyle

Ottiene le proprietà di stile per la sezione del piè di pagina della colonna.Gets the style properties for the footer section of the column.

(Inherited from DataGridColumn)
FooterText FooterText FooterText FooterText

Ottiene o imposta il testo visualizzato nella sezione del piè di pagina della colonna.Gets or sets the text displayed in the footer section of the column.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione di intestazione della colonna.Gets or sets the location of an image to display in the header section of the column.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Ottiene le proprietà di stile per la sezione di intestazione della colonna.Gets the style properties for the header section of the column.

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText HeaderText

Ottiene o imposta il testo visualizzato nella sezione di intestazione della colonna.Gets or sets the text displayed in the header section of the column.

(Inherited from DataGridColumn)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ottiene un valore che indica se nella colonna vengono registrate le modifiche dello stato di visualizzazione.Gets a value that indicates whether the column is tracking view state changes.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per il salvataggio dello stato.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

Ottiene le proprietà di stile per le celle degli elementi della colonna.Gets the style properties for the item cells of the column.

(Inherited from DataGridColumn)
Owner Owner Owner Owner

Ottiene il controllo DataGrid di cui la colonna è membro.Gets the DataGrid control that the column is a member of.

(Inherited from DataGridColumn)
SortExpression SortExpression SortExpression 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.Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(Inherited from DataGridColumn)
Text Text Text Text

Ottiene o imposta la didascalia visualizzata nei pulsanti dell'oggetto ButtonColumn.Gets or sets the caption that is displayed in the buttons of the ButtonColumn object.

ValidationGroup ValidationGroup ValidationGroup 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.Gets or sets the group of validation controls for which the ButtonColumn object causes validation when it posts back to the server.

ViewState ViewState ViewState ViewState

Ottiene l'oggetto StateBag che consente a una colonna derivata dalla classe DataGridColumn di memorizzare le relative proprietà.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Inherited from DataGridColumn)
Visible Visible Visible Visible

Ottiene o imposta un valore che indica se la colonna è visibile nel controllo DataGrid.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Inherited from DataGridColumn)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object)

Converte il valore specificato nel formato indicato dalla proprietà DataTextFormatString.Converts the specified value to the format that is indicated by the DataTextFormatString property.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

Ripristina lo stato iniziale dell'oggetto ButtonColumn.Resets the ButtonColumn object to its initial state.

InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType)

Ripristina lo stato iniziale di una cella dell'oggetto ButtonColumn.Resets a cell in the ButtonColumn object to its initial state.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Carica lo stato dell'oggetto DataGridColumn.Loads the state of the DataGridColumn object.

(Inherited from DataGridColumn)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnColumnChanged() OnColumnChanged() OnColumnChanged() OnColumnChanged()

Chiama il metodo OnColumnsChanged().Calls the OnColumnsChanged() method.

(Inherited from DataGridColumn)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Salva lo stato corrente dell'oggetto DataGridColumn.Saves the current state of the DataGridColumn object.

(Inherited from DataGridColumn)
ToString() ToString() ToString() ToString()

Restituisce la rappresentazione in forma di stringa della colonna.Returns the string representation of the column.

(Inherited from DataGridColumn)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(Inherited from DataGridColumn)

Implementazioni dell'interfaccia esplicita

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Carica lo stato salvato in precedenza.Loads previously saved state.

(Inherited from DataGridColumn)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Restituisce un oggetto contenente le modifiche dello stato.Returns an object containing state changes.

(Inherited from DataGridColumn)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Avvia la registrazione delle modifiche dello stato.Starts tracking state changes.

(Inherited from DataGridColumn)

Si applica a

Vedi anche