ButtonFieldBase ButtonFieldBase ButtonFieldBase ButtonFieldBase Class

Definition

Dient als abstrakte Basisklasse für die Schaltflächenfelder, wie z. B. die ButtonField- oder CommandField-Klasse.Serves as the abstract base class for button fields, such as the ButtonField or CommandField class. Die ButtonFieldBase-Klasse stellt die Methoden und Eigenschaften bereit, die für alle Schaltflächenfelder gelten.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
Vererbung
ButtonFieldBaseButtonFieldBaseButtonFieldBaseButtonFieldBase
Abgeleitet

Hinweise

Die ButtonFieldBase -Klasse ist die abstrakte Basisklasse für Schaltflächen Felder und enthält die Methoden und Eigenschaften, die für alle Schaltflächen Felder gelten.The ButtonFieldBase class is the abstract base class for button fields and contains the methods and properties that are common to all button fields. Da diese Klasse abstrakt ist, können Sie eine Instanz davon nicht direkt erstellen.Because this class is abstract, you cannot create an instance of it directly. Stattdessen müssen Sie eine Instanz einer nicht abstrakten Klasse erstellen, die von der ButtonFieldBase -Klasse erbt, z. b. die-Klasse oder CommandField die ButtonField -Klasse.Instead, you must create an instance of a non-abstract class that inherits from the ButtonFieldBase class, such as the ButtonField or CommandField class.

Ein Objekt, das von ButtonFieldBase abgeleitet wird, wird von Daten gebundenen Steuerelementen (z. b. den GridView Steuerelementen und DetailsView ) verwendet, um eine oder mehrere Schaltflächen für jeden angezeigten Datensatz anzuzeigen.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. Ein Schaltflächen Feld wird je nach dem Daten gebundenen Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt.A button field is displayed differently depending on the data-bound control in which it is used. Das GridView -Steuerelement zeigt z. b. ein Schaltflächen Feld als Spalte DetailsView an, während das-Steuerelement es als Zeile anzeigt.For example, the GridView control displays a button field as a column, whereas the DetailsView control displays it as a row.

Wenn Sie auf eine Schaltfläche in einem Schaltflächen Feld klicken, wird das Befehls Ereignis des übergeordneten Daten gebundenen Steuer Elements ausgelöst.Clicking a button in a button field raises the command event of the parent data-bound control. Sie können eine benutzerdefinierte Routine bereitstellen, die beim Klicken auf eine Schaltfläche durchgeführt wird, indem Sie einen Ereignishandler für das Befehls Ereignis bereitstellen.You can provide a custom routine to perform when a button is clicked by providing an event handler for the command event.

Hinweis

Das GridView Steuerelement löst RowCommand das-Ereignis aus DetailsView , während das ItemCommand -Steuerelement das-Ereignis auslöst.The GridView control raises the RowCommand event, whereas the DetailsView control raises the ItemCommand event.

Um den Typ der anzuzeigenden Schaltfläche anzugeben, ButtonType verwenden Sie die-Eigenschaft.To specify the type of button to display, use the ButtonType property. Um den Header Abschnitt eines ButtonFieldBase -Objekts anzuzeigen oder auszublenden, legen Sie die ShowHeader -Eigenschaft fest.To show or hide the header section of a ButtonFieldBase object, set the ShowHeader property.

Hinweis

Einige Daten gebundene Steuerelemente (z. b GridView . das-Steuerelement) können nur den gesamten Header Abschnitt des Steuer Elements anzeigen oder ausblenden.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Diese Daten gebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes Schaltflächen Feld nicht.These data-bound controls do not support the ShowHeader property for an individual button field. Um den gesamten Header Abschnitt eines Daten gebundenen Steuer Elements (sofern vorhanden) anzuzeigen oder auszublenden, verwenden Sie ShowHeader die-Eigenschaft für das-Steuerelement.To show or hide the entire header section of a data-bound control (if available), use the ShowHeader property for the control.

Hinweise für Vererber

Wenn Sie von der ButtonFieldBase -Klasse erben, müssen Sie den folgenden Member überschreiben:. CopyProperties(DataControlField)When you inherit from the ButtonFieldBase class, you must override the following member: CopyProperties(DataControlField).

Konstruktoren

ButtonFieldBase() ButtonFieldBase() ButtonFieldBase() ButtonFieldBase()

Initialisiert eine neue Instanz der ButtonFieldBase-Klasse.Initializes a new instance of the ButtonFieldBase class.

Eigenschaften

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Inherited from DataControlField)
ButtonType ButtonType ButtonType ButtonType

Ruft den Schaltflächentyp ab, der im Schaltflächenfeld angezeigt werden soll, oder legt diesen fest.Gets or sets the button type to display in the button field.

CausesValidation CausesValidation CausesValidation CausesValidation

Ruft einen Wert ab, der angibt, ob beim Klicken auf eine Schaltfläche in einem ButtonFieldBase-Objekt eine Validierung durchgeführt wird, oder legt diesen fest.Gets or sets a value indicating whether validation is performed when a button in a ButtonFieldBase object is clicked.

Control Control Control Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

(Inherited from DataControlField)
ControlStyle ControlStyle ControlStyle ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

(Inherited from DataControlField)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Inherited from DataControlField)
FooterStyle FooterStyle FooterStyle FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

(Inherited from DataControlField)
FooterText FooterText FooterText FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

(Inherited from DataControlField)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Inherited from DataControlField)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

(Inherited from DataControlField)
HeaderText HeaderText HeaderText HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the header item of a data control field.

(Inherited from DataControlField)
IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

(Inherited from DataControlField)
InsertVisible InsertVisible InsertVisible InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Inherited from DataControlField)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
ItemStyle ItemStyle ItemStyle ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

(Inherited from DataControlField)
ShowHeader ShowHeader ShowHeader ShowHeader

Ruft einen Wert ab, der angibt, ob der Headerbereich in einem ButtonFieldBase-Objekt angezeigt wird, oder legt diesen Wert fest.Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.

SortExpression SortExpression SortExpression SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

(Inherited from DataControlField)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that specifies whether the control validates client input.

(Inherited from DataControlField)
ValidationGroup ValidationGroup ValidationGroup ValidationGroup

Ruft den Namen der Gruppe von Validierungssteuerelementen ab, die beim Klicken auf eine Schaltfläche in einem ButtonFieldBase-Objekt validiert werden sollen, oder legt diesen fest.Gets or sets the name of the group of validation controls to validate when a button in a ButtonFieldBase object is clicked.

ViewState ViewState ViewState ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.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.

(Inherited from DataControlField)
Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

(Inherited from DataControlField)

Methoden

CloneField() CloneField() CloneField() CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

(Inherited from DataControlField)
CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen Objekts, das von der ButtonFieldBase-Klasse abgeleitet ist, in das angegebene DataControlField-Objekt.Copies the properties of the current object that is derived from the ButtonFieldBase class to the specified DataControlField object.

CreateField() CreateField() CreateField() CreateField()

Beim Überschreiben in einer abgeleiteten Klasse wird ein leeres, von DataControlField abgeleitetes Objekt erstellt.When overridden in a derived class, creates an empty DataControlField-derived object.

(Inherited from DataControlField)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahiert den Wert des Datensteuerelement-Felds aus der aktuellen Tabellenzelle und fügt den Wert der angegebenen IDictionary-Auflistung hinzu.Extracts the value of the data control field from the current table cell and adds the value to the specified IDictionary collection.

(Inherited from DataControlField)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control)

Führt eine grundlegende Instanzinitialisierung für ein Datensteuerelement-Feld aus.Performs basic instance initialization for a data control field.

(Inherited from DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Fügt der Steuerelementauflistung einer Zelle Text oder Steuerelemente hinzu.Adds text or controls to a cell's controls collection.

(Inherited from DataControlField)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Inherited from DataControlField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

(Inherited from DataControlField)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

(Inherited from DataControlField)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.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.

(Inherited from DataControlField)
ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback()

Signalisiert beim Überschreiben in einer abgeleiteten Klasse, dass die in einem Feld enthaltenen Steuerelemente Rückrufe unterstützen.When overridden in a derived class, signals that the controls contained by a field support callbacks.

(Inherited from DataControlField)

Explizite Schnittstellenimplementierungen

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

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

(Inherited from DataControlField)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.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.

(Inherited from DataControlField)

Gilt für:

Siehe auch