SqlDataSourceSelectingEventArgs Klasse

Definition

Stellt Daten für das Selecting-Ereignis des SqlDataSource-Steuerelements bereit.Provides data for the Selecting event of the SqlDataSource control.

public ref class SqlDataSourceSelectingEventArgs : System::Web::UI::WebControls::SqlDataSourceCommandEventArgs
public class SqlDataSourceSelectingEventArgs : System.Web.UI.WebControls.SqlDataSourceCommandEventArgs
type SqlDataSourceSelectingEventArgs = class
    inherit SqlDataSourceCommandEventArgs
Public Class SqlDataSourceSelectingEventArgs
Inherits SqlDataSourceCommandEventArgs
Vererbung

Hinweise

Wenn Sie einen Ereignishandlerdelegaten hinzufügen, um das-Ereignis zu behandeln Selecting , können Sie jede zusätzliche Vorverarbeitung ausführen oder die Datenbankabfrage vollständig abbrechen.By adding an event handler delegate to handle the Selecting event, you can perform any additional preprocessing required or cancel the database query entirely. Da die- SqlDataSourceSelectingEventArgs Klasse von der- SqlDataSourceCommandEventArgs Klasse abgeleitet ist, können Sie eine ausstehende SqlDataSource Datenbankabfrage abbrechen, indem Sie die- Cancel Eigenschaft auf festlegen true .Because the SqlDataSourceSelectingEventArgs class is derived from the SqlDataSourceCommandEventArgs class, you can cancel a pending SqlDataSource database query by setting the Cancel property to true. Sie können die-Auflistung CommandText Parameters und andere Datenbankabfrage Eigenschaften vor dem Ausführen der Abfrage überprüfen und bearbeiten, indem Sie auf das-Objekt zugreifen, das DbCommand von der-Eigenschaft verfügbar gemacht wird Command .You can examine and manipulate the CommandText, Parameters collection, and other database query properties prior to running the query by accessing the DbCommand object exposed by the Command property. Sie können auch das Objekt überprüfen DataSourceSelectArguments , das an die Methode übermittelt wird, indem Sie auf Select die- Arguments Eigenschaft zugreifen.You can also examine the DataSourceSelectArguments object that is passed to the Select method by accessing the Arguments property.

Die- SqlDataSourceSelectingEventArgs Klasse wird in der- OnSelecting Methode verwendet, um den Zugriff auf eine Datenbankabfrage bereitzustellen, SqlDataSource bevor Sie ausgeführt wird.The SqlDataSourceSelectingEventArgs class is used in the OnSelecting method to provide access to a SqlDataSource database query before it is run.

Das-Steuerelement macht SqlDataSource viele Ereignisse verfügbar, die Sie behandeln können, um während eines Daten Vorgangs mit den zugrunde liegenden Datenobjekten zu arbeiten.The SqlDataSource control exposes many events that you can handle to work with the underlying data objects during the course of a data operation. In der folgenden Tabelle werden die Ereignisse und zugeordneten EventArgs Klassen und Ereignishandlerdelegaten aufgelistet.The following table lists the events and associated EventArgs classes and event handler delegates.

EreignisEvent EventArgsEventArgs EventHandlerEventHandler
Selecting.Selecting.

Tritt ein, bevor die Daten abgerufen werden.Occurs before the data is retrieved.
SqlDataSourceSelectingEventArgs SqlDataSourceSelectingEventHandler
Inserting, Updatingund Deleting.Inserting, Updating, and Deleting.

Tritt auf, bevor ein INSERT-, Update-oder DELETE-Vorgang ausgeführt wird.Occur before an insert, update, or delete operation is performed.
SqlDataSourceCommandEventArgs SqlDataSourceCommandEventHandler
Selected, Inserted, Updated und Deleted.Selected, Inserted, Updated, and Deleted.

Tritt auf, nachdem der Vorgang zum Abrufen, einfügen, aktualisieren oder Löschen von Daten abgeschlossen wurde.Occur after the data retrieval, insert, update, or delete operation completes.
SqlDataSourceStatusEventArgs SqlDataSourceStatusEventHandler

Konstruktoren

SqlDataSourceSelectingEventArgs(DbCommand, DataSourceSelectArguments)

Initialisiert eine neue Instanz der SqlDataSourceSelectingEventArgs-Klasse unter Verwendung des angegebenen DbCommand-Objekts und aller an die DataSourceSelectArguments-Methode übergebenen Select(DataSourceSelectArguments).Initializes a new instance of the SqlDataSourceSelectingEventArgs class, using the specified DbCommand object and any DataSourceSelectArguments passed to the Select(DataSourceSelectArguments) method.

Eigenschaften

Arguments

Ruft das an die DataSourceSelectArguments-Methode übergebene Select(DataSourceSelectArguments)-Objekt ab.Gets the DataSourceSelectArguments object passed to the Select(DataSourceSelectArguments) method.

Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Geerbt von CancelEventArgs)
Command

Ruft den ausstehenden Datenbankbefehl ab.Gets the pending database command.

(Geerbt von SqlDataSourceCommandEventArgs)

Methoden

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch