SqlDataSourceView.Filtering イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlDataSourceView.Filtering イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

フィルタ操作の前に発生します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Event Filtering As
 SqlDataSourceFilteringEventHandler

Visual Basic (使用法)

Dim instance As SqlDataSourceView
Dim handler As SqlDataSourceFilteringEventHandler

AddHandler instance.Filtering, handler

public event SqlDataSourceFilteringEventHandler Filtering

C++

public:
event SqlDataSourceFilteringEventHandler^ Filtering {
    void add (SqlDataSourceFilteringEventHandler^ value);
    void remove (SqlDataSourceFilteringEventHandler^ value);
}

/** @event */
public void add_Filtering (SqlDataSourceFilteringEventHandler
 value)

/** @event */
public void remove_Filtering (SqlDataSourceFilteringEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

Filtering イベントを処理して、SqlDataSourceView オブジェクトがフィルタ処理を実行する前に、フィルタパラメータ値の検証操作を実行します。SqlDataSourceFilteringEventArgs オブジェクトの Cancel プロパティを true に設定すると、Select メソッドをキャンセルできます。このイベントは、FilterExpression プロパティが設定されている場合にだけ発生します。

セキュリティに関するメモ
クライアントから受け取ったフィルタパラメータ値を検証する必要があります。ランタイムは、パラメータ値をフィルタ式に代入して、Select メソッドによって返される DataView オブジェクトに適用します。FilterExpression プロパティをセキュリティ対策として使用して、返されるアイテムの数を制限している場合は、フィルタ処理が行われる前に、パラメータ値を検証する必要があります。