CatalogZone.CreateCatalogParts 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

建立區域中宣告之每個 CatalogPart 型別的執行個體。

protected:
 override System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ CreateCatalogParts();

protected override System.Web.UI.WebControls.WebParts.CatalogPartCollection CreateCatalogParts ();

override this.CreateCatalogParts : unit -> System.Web.UI.WebControls.WebParts.CatalogPartCollection

Protected Overrides Function CreateCatalogParts () As CatalogPartCollection

傳回

CatalogPartCollection

CatalogPartCollection，其中含有區域中所有 CatalogPart 控制項的參考。

例外狀況

InvalidOperationException

目前的 CatalogPart 控制項並沒有 ID。

備註

方法是 CreateCatalogParts 重要的方法，因為當使用者將頁面切換至目錄顯示模式時，此方法會建立組成網頁元件目錄的所有 CatalogPart 控制件。

提供給 CreateCatalogParts Web 元件控制項集之 CatalogZone 類別中的 方法，可以建立繼承自 CatalogPart 類別的任何伺服器控制件。 因此，如果您建立自定義 CatalogPart 控件並在控件內的 CatalogZone 頁面上宣告它，則當使用者將頁面切換至類別目錄模式時，此方法會建立控件。

不過，基於各種原因，您可能會想要控制 CreateCatalogParts 方法。 您可能只想要建立特定 CatalogPart 控制件。 例如，假設您建立一組具有一致外觀且屬於單一產品或組織的自定義 CatalogPart 控件。 如果您想要將頁面開發人員限制在目錄中使用這些自定義控件，則您應該繼承自 CatalogZone 類別、覆寫 CreateCatalogParts 方法，並允許方法只建立與自定義控件相同類型的控件。

另請參閱

• CreateCatalogParts()
• ASP.NET 網頁元件控制件