ObjectDataSourceView.Filtering イベント

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

ObjectDataSourceView.Filtering イベント

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

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

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

Visual Basic (宣言)

Public Event Filtering As
 ObjectDataSourceFilteringEventHandler

Visual Basic (使用法)

Dim instance As ObjectDataSourceView
Dim handler As ObjectDataSourceFilteringEventHandler

AddHandler instance.Filtering, handler

C#

public event ObjectDataSourceFilteringEventHandler Filtering

C++

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

J#

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

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

JScript

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

解説

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

イベント処理の詳細については、「イベントの利用」を参照してください。

セキュリティに関するメモ
クライアントから受け取るフィルタ パラメータ値を検証する必要があります。ランタイムは、パラメータ値をフィルタ式に置き換えて、Select メソッドから返される DataView オブジェクトに適用するだけです。返される項目数を制限するセキュリティ手段として FilterExpression プロパティを使用している場合、フィルタ処理の実行前にパラメータ値を検証する必要があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ObjectDataSourceView クラス
ObjectDataSourceView メンバ
System.Web.UI.WebControls 名前空間
ObjectDataSource.Filtering イベント
ObjectDataSource.FilterExpression プロパティ
ObjectDataSource.FilterParameters プロパティ