ObjectDataSource.Filtering Ereignis

Definition

Tritt vor einem Filtervorgang auf.Occurs before a filter operation.

public:
 event System::Web::UI::WebControls::ObjectDataSourceFilteringEventHandler ^ Filtering;
public event System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler Filtering;
member this.Filtering : System.Web.UI.WebControls.ObjectDataSourceFilteringEventHandler 
Public Custom Event Filtering As ObjectDataSourceFilteringEventHandler 

Hinweise

Behandeln Sie das Filtering-Ereignis, um Validierungs Vorgänge für Filter Parameterwerte auszuführen, bevor das ObjectDataSource-Steuerelement einen Filter Vorgang ausführt.Handle the Filtering event to perform validation operations on filter parameter values before the ObjectDataSource control performs a filter operation. Sie können den ausgewählten Vorgang abbrechen, indem Sie die Cancel-Eigenschaft des ObjectDataSourceFilteringEventArgs auf truefestlegen.You can cancel the selected operation by setting the Cancel property of the ObjectDataSourceFilteringEventArgs to true. Das-Ereignis wird nur ausgelöst, wenn die FilterExpression-Eigenschaft festgelegt ist.The event is raised only if the FilterExpression property is set.

Das ObjectDataSource.Filtering-Ereignis delegiert an das ObjectDataSourceView.Filtering-Ereignis der ObjectDataSourceView, die dem ObjectDataSource Steuerelement zugeordnet ist.The ObjectDataSource.Filtering event delegates to the ObjectDataSourceView.Filtering event of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Wichtig

Sie sollten jeden Filter Parameterwert validieren, den Sie vom Client erhalten.You should validate any filter parameter value that you receive from the client. Die Runtime ersetzt einfach den Parameterwert in den Filter Ausdruck und wendet Sie auf die DataSet oder DataTable Objekt an, das von der Select-Methode zurückgegeben wird.The runtime simply substitutes the parameter value into the filter expression and applies it to the DataSet or DataTable object that is returned by the Select method. Wenn Sie die FilterExpression-Eigenschaft als Sicherheitsmaßnahme verwenden, um die Anzahl der zurückgegebenen Elemente einzuschränken, müssen Sie die Parameterwerte vor dem Filtern überprüfen.If you are using the FilterExpression property as a security measure to limit the number of items that are returned, you must validate the parameter values before the filtering occurs.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Gilt für:

Siehe auch