ButtonFieldBase Classe

Definizione

Funge da classe base astratta per i campi pulsante, come la classe ButtonField o CommandField.Serves as the abstract base class for button fields, such as the ButtonField or CommandField class. La classe ButtonFieldBase fornisce i metodi e le proprietà comuni a tutti i campi pulsante.The ButtonFieldBase class provides the methods and properties that are common to all button fields.

public ref class ButtonFieldBase abstract : System::Web::UI::WebControls::DataControlField
public abstract class ButtonFieldBase : System.Web.UI.WebControls.DataControlField
type ButtonFieldBase = class
    inherit DataControlField
Public MustInherit Class ButtonFieldBase
Inherits DataControlField
Ereditarietà
ButtonFieldBase
Derivato

Commenti

La ButtonFieldBase classe è la classe base astratta per i campi pulsante e contiene i metodi e le proprietà comuni a tutti i campi pulsante.The ButtonFieldBase class is the abstract base class for button fields and contains the methods and properties that are common to all button fields. Poiché questa classe è astratta, non è possibile crearne direttamente un'istanza.Because this class is abstract, you cannot create an instance of it directly. È invece necessario creare un'istanza di una classe non astratta che erediti dalla ButtonFieldBase classe, ad esempio la ButtonField classe o CommandField .Instead, you must create an instance of a non-abstract class that inherits from the ButtonFieldBase class, such as the ButtonField or CommandField class.

Un oggetto derivato da ButtonFieldBase viene usato dai controlli con associazione a dati, ad esempio i GridView controlli e DetailsView , per visualizzare uno o più pulsanti per ogni record visualizzato.An object that is derived from the ButtonFieldBase is used by data-bound controls (such as the GridView and DetailsView controls) to display one or more buttons for each record that is displayed. Un campo Button viene visualizzato in modo diverso a seconda del controllo con associazione a dati in cui viene usato.A button field is displayed differently depending on the data-bound control in which it is used. Ad esempio, il GridView controllo Visualizza un campo Button come colonna, mentre il controllo DetailsView lo Visualizza come riga.For example, the GridView control displays a button field as a column, whereas the DetailsView control displays it as a row.

Quando si fa clic su un pulsante in un campo pulsante, viene generato l'evento di comando del controllo con associazione a dati padre.Clicking a button in a button field raises the command event of the parent data-bound control. È possibile fornire una routine personalizzata da eseguire quando si fa clic su un pulsante fornendo un gestore eventi per l'evento di comando.You can provide a custom routine to perform when a button is clicked by providing an event handler for the command event.

Nota

Il GridView controllo genera l' RowCommand evento, mentre il DetailsView controllo genera l' ItemCommand evento.The GridView control raises the RowCommand event, whereas the DetailsView control raises the ItemCommand event.

Per specificare il tipo di pulsante da visualizzare, utilizzare la ButtonType proprietà.To specify the type of button to display, use the ButtonType property. Per visualizzare o nascondere la sezione di intestazione di ButtonFieldBase un oggetto, impostare ShowHeader la proprietà.To show or hide the header section of a ButtonFieldBase object, set the ShowHeader property.

Nota

Alcuni controlli associati a dati, ad esempio il GridView controllo, possono visualizzare o nascondere solo l'intera sezione di intestazione del controllo.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo Button.These data-bound controls do not support the ShowHeader property for an individual button field. Per visualizzare o nascondere l'intera sezione di intestazione di un controllo con associazione a dati (se disponibile), ShowHeader utilizzare la proprietà per il controllo.To show or hide the entire header section of a data-bound control (if available), use the ShowHeader property for the control.

Note per gli implementatori

Quando si eredita dalla ButtonFieldBase classe, è necessario eseguire l'override del membro seguente:. CopyProperties(DataControlField)When you inherit from the ButtonFieldBase class, you must override the following member: CopyProperties(DataControlField).

Costruttori

ButtonFieldBase()

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

Proprietà

AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Ereditato da DataControlField)
ButtonType

Ottiene o imposta il tipo di pulsante da visualizzare nel campo pulsante.Gets or sets the button type to display in the button field.

CausesValidation

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

Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.Gets a reference to the data control that the DataControlField object is associated with.

(Ereditato da DataControlField)
ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Ereditato da DataControlField)
DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Ereditato da DataControlField)
FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.Gets or sets the style of the footer of the data control field.

(Ereditato da DataControlField)
FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.Gets or sets the text that is displayed in the footer item of a data control field.

(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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Ereditato da DataControlField)
HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.Gets or sets the style of the header of the data control field.

(Ereditato da DataControlField)
HeaderText

Ottiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati.Gets or sets the text that is displayed in the header item of a data control field.

(Ereditato da DataControlField)
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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Ereditato da DataControlField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Ereditato da DataControlField)
ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.Gets the style of any text-based content displayed by a data control field.

(Ereditato da DataControlField)
ShowHeader

Ottiene o imposta un valore che indica se la sezione di intestazione viene visualizzata in un oggetto ButtonFieldBase.Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.

SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.Gets or sets a sort expression that is used by a data source control to sort data.

(Ereditato da DataControlField)
ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.Gets or sets a value that specifies whether the control validates client input.

(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.Gets or sets the name of the group of validation controls to validate when a button in a ButtonFieldBase object is clicked.

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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Ereditato da DataControlField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.Gets or sets a value indicating whether a data control field is rendered.

(Ereditato da DataControlField)

Metodi

CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Ereditato da DataControlField)
CopyProperties(DataControlField)

Copia le proprietà dell'oggetto corrente derivato dalla classe ButtonFieldBase nell'oggetto DataControlField specificato.Copies the properties of the current object that is derived from the ButtonFieldBase class to the specified DataControlField object.

CreateField()

Quando viene sottoposto a override in una classe derivata, crea un oggetto vuoto derivato da DataControlField.When overridden in a derived class, creates an empty DataControlField-derived object.

(Ereditato da DataControlField)
Equals(Object)

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

(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.Extracts the value of the data control field from the current table cell and adds the value to the specified IDictionary collection.

(Ereditato da DataControlField)
GetHashCode()

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

(Ereditato da Object)
GetType()

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

(Ereditato da Object)
Initialize(Boolean, Control)

Esegue un'inizializzazione dell'istanza di base per un campo di controllo dati.Performs basic instance initialization for a data control field.

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

Aggiunge testo o controlli all'insieme dei controlli di una cella.Adds text or controls to a cell's controls collection.

(Ereditato da DataControlField)
LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

(Ereditato da DataControlField)
MemberwiseClone()

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

(Ereditato da Object)
OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Ereditato da DataControlField)
ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Ereditato da DataControlField)
ValidateSupportsCallback()

Quando si esegue l'override in una classe derivata, segnala che i controlli contenuti in un campo supportano i callback.When overridden in a derived class, signals that the controls contained by a field support callbacks.

(Ereditato da DataControlField)

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Ereditato da DataControlField)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Ereditato da DataControlField)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.Restores the data control field's previously saved view state.

(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.Saves the changes made to the DataControlField view state since the time the page was posted back to the 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Ereditato da DataControlField)

Si applica a

Vedi anche