WebPartZone.GetInitialWebParts メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

抽象基本メソッドをオーバーライドして、ゾーンのテンプレート内に格納されている静的な WebPart コントロールの初期セットを取得します。

protected public:
 override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();

protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();

override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollection

Protected Friend Overrides Function GetInitialWebParts () As WebPartCollection

戻り値

WebPartCollection

ゾーンのテンプレート内に格納されているすべての WebPartCollection または他のサーバー コントロールが含まれている WebPart。

注釈

メソッドは GetInitialWebParts 、抽象基本 GetInitialWebParts メソッドの実装を提供します。 基本メソッドは実装を提供しませんが、 メソッドを宣言して、派生クラスがパーソナル化の変更を考慮せずに、ゾーンに属するコントロールの初期セットを取得する方法をカスタマイズできるようにします。

ゾーン内のサーバー コントロールごとに、 メソッドが CreateWebPart 呼び出されます。 コントロールが クラスから直接継承される WebPart 場合、単にゾーンのコレクション (およびコントロールの同様の WebParts コレクション WebPartManager ) に追加されます。 コントロールが から WebPart直接継承されない場合、Web パーツ コントロール セットは コントロールを オブジェクトで GenericWebPart ラップします。これにより、コントロールは実行時にコントロールとして WebPart 動作します。

クラスは WebPartZone 、Web パーツ ページのマークアップ内のタグのセット内で静的に宣言されているコントロールの <zonetemplate> セット (存在する場合) を返すことによって、基本メソッドを実装します。 コントロールが PlaceHolder ゾーンで宣言されている場合、コントロール自体ではなく、そのコントロールの子コントロールが追加されます。 この実装では、たとえば、マスター ページにゾーンを WebPartZone 作成し、コンテンツ ページで個々 WebPart のコントロールまたはサーバー コントロールを宣言できます。 ゾーンでWebPartZoneコントロールを宣言Literalした場合、コントロールは無視されます。

注意

メソッドによって GetInitialWebParts 返されるコントロールの最初のコレクションは、パーソナル化が行われた後、ゾーン内のコントロールの実際の実行時コレクションとは異なる場合があります。 たとえば、2 つの WebPartZone コントロールを含む Web ページがあり、最初のページには タグ内で静的に宣言された という名前 User1 のユーザー コントロールが <zonetemplate> 含まれているとします。 ユーザーがページを読み込んで 2 番目のゾーンにドラッグ User1 した場合でも、 User1 そのゾーンで宣言されているため、最初のゾーンの メソッドを GetInitialWebParts 呼び出して返されるコレクションの一部です。 ただし、実行時にコントロールがパーソナル化データを WebPartManager 読み込むと、 User1 実際にはユーザーがドラッグした 2 番目のゾーンに表示されます。

こちらもご覧ください

• ZoneTemplate
• ASP.NET Web パーツ コントロール