TreeView.OnTreeNodePopulate(TreeNodeEventArgs) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)パラメーター
イベント データを格納している TreeNodeEventArgs。
注釈
場合によっては、データ サイズやユーザー入力に依存するカスタム コンテンツが原因で、ツリー構造を静的に事前に定義することは実用的ではありません。 このため、コントロールは TreeView 動的ノードの作成をサポートします。 ノードの PopulateOnDemand プロパティが に true設定されている場合、そのノードは、ノードが展開されるときに実行時に設定されます。
ノードを動的に設定するには、最初にノードの プロパティを PopulateOnDemand に true設定します。 次に、プログラムによってノードを設定するイベントの TreeNodePopulate イベント処理メソッドを定義します。 一般的なイベント処理メソッドは、データ ソースからノード データを取得し、データをノード構造に配置してから、設定されているノードのコレクションに ChildNodes ノード構造を追加します。 ノード構造は、親ノードのコレクションにオブジェクトをChildNodes追加TreeNodeすることによって作成されます。
注意
ノードの PopulateOnDemand プロパティが に true設定されている場合は、ノードを動的に設定する必要があります。 宣言によってその下に別のノードを入れ子にすることはできません。それ以外の場合は、ページでエラーが発生します。
サポートされているブラウザー (Microsoft インターネット エクスプローラー 4.0 互換ブラウザー以降) でも、クライアント側ノードの作成を利用できます。 有効にすると、コントロールは TreeView 、そのノードが展開されたときにクライアント上のノードを動的に設定できるため、サーバーにポストバックする必要がなくなります。 クライアント側ノードの作成の詳細については、「」を参照してください PopulateNodesFromClient。
イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。 イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。
OnTreeNodePopulate メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。 派生クラスでイベントを処理する場合は、この手法をお勧めします。
注意 (継承者)
派生クラスで メソッドをオーバーライドする OnTreeNodePopulate(TreeNodeEventArgs) 場合は、登録されているデリゲートがイベントを OnTreeNodePopulate(TreeNodeEventArgs) 受け取るように、基底クラスの メソッドを必ず呼び出してください。
適用対象
こちらもご覧ください
.NET