WebPartZone.GetInitialWebParts メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
抽象基本メソッドをオーバーライドして、ゾーンのテンプレート内に格納されている静的な 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.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As 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 番目のゾーンに表示されます。