TreeView.OnTreeNodePopulate(TreeNodeEventArgs) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

TreeNodePopulate コントロールの TreeView イベントを発生させます。

protected:
 virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);
protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);
abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

パラメーター

e
TreeNodeEventArgs

イベント データを格納している TreeNodeEventArgs。

注釈

場合によっては、データ サイズやユーザー入力に依存するカスタム コンテンツが原因で、ツリー構造を静的に事前に定義することは実用的ではありません。 このため、コントロールは TreeView 動的ノードの作成をサポートします。 ノードの PopulateOnDemand プロパティが に true設定されている場合、そのノードは、ノードが展開されるときに実行時に設定されます。

ノードを動的に設定するには、最初にノードの プロパティを PopulateOnDemand に true設定します。 次に、プログラムによってノードを設定するイベントの TreeNodePopulate イベント処理メソッドを定義します。 一般的なイベント処理メソッドは、データ ソースからノード データを取得し、データをノード構造に配置してから、設定されているノードのコレクションに ChildNodes ノード構造を追加します。 ノード構造は、親ノードのコレクションにオブジェクトをChildNodes追加TreeNodeすることによって作成されます。

注意

ノードの PopulateOnDemand プロパティが に true設定されている場合は、ノードを動的に設定する必要があります。 宣言によってその下に別のノードを入れ子にすることはできません。それ以外の場合は、ページでエラーが発生します。

サポートされているブラウザー (Microsoft インターネット エクスプローラー 4.0 互換ブラウザー以降) でも、クライアント側ノードの作成を利用できます。 有効にすると、コントロールは TreeView 、そのノードが展開されたときにクライアント上のノードを動的に設定できるため、サーバーにポストバックする必要がなくなります。 クライアント側ノードの作成の詳細については、「」を参照してください PopulateNodesFromClient。

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。 イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。

OnTreeNodePopulate メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。 派生クラスでイベントを処理する場合は、この手法をお勧めします。

注意 (継承者)

派生クラスで メソッドをオーバーライドする OnTreeNodePopulate(TreeNodeEventArgs) 場合は、登録されているデリゲートがイベントを OnTreeNodePopulate(TreeNodeEventArgs) 受け取るように、基底クラスの メソッドを必ず呼び出してください。

適用対象

こちらもご覧ください