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 一种关键方法，因为当用户将页面切换到目录显示模式时，此方法将创建构成 Web 部件目录的所有 CatalogPart 控件。

CreateCatalogParts随 Web 部件控件集一起提供的 类中的 CatalogZone 方法可以创建继承自 CatalogPart 类的任何服务器控件。 因此，如果创建自定义 CatalogPart 控件并在控件内的 CatalogZone 页面上声明它，则当用户将页面切换到目录模式时，此方法将创建控件。

但是，出于各种原因，可能需要控制 CreateCatalogParts 方法。 你可能希望它仅创建某些 CatalogPart 控件。 例如，假设创建一组外观一致且属于单个产品或组织的自定义 CatalogPart 控件。 如果希望页面开发人员仅限于在目录中使用这些自定义控件，则应从 CatalogZone 类继承，重写 CreateCatalogParts 方法，并允许 方法仅创建与自定义控件类型相同的控件。

另请参阅

• CreateCatalogParts()
• ASP.NET Web 部件控件