CatalogZoneBase.CatalogParts 屬性

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

取得 CatalogPart 區域中包含之所有 CatalogZoneBase 控制項的集合。

public:
 property System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ CatalogParts { System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.CatalogPartCollection CatalogParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CatalogParts : System.Web.UI.WebControls.WebParts.CatalogPartCollection

Public ReadOnly Property CatalogParts As CatalogPartCollection

屬性值

CatalogPartCollection

CatalogPartCollection，包含區域中的所有個別 CatalogPart 控制項。

屬性

BrowsableAttribute

例外狀況

InvalidOperationException

加入集合中的 CatalogPart 未對其 ID 屬性指派任何值。

範例

下列程式代碼範例示範如何以程序設計方式存取 CatalogParts 屬性。 如需執行範例所需的完整程式碼，請參閱類別概觀的 CatalogZoneBase 範例一節。

程式代碼範例示範如何存取 CatalogParts 屬性、逐一查看集合，並列出區域中所有 CatalogPart 控件的標識碼。

protected void Button2_Click(object sender, EventArgs e)
{
  Label1.Text = "<h3>CatalogPart List</h3>";
  foreach(CatalogPart part in CatalogZone1.CatalogParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Protected Sub Button2_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  Label1.Text = "<h3>CatalogPart List</h3>"
  Dim part As CatalogPart
  For Each part In CatalogZone1.CatalogParts
    Label1.Text += part.ID + "<br />"
  Next part

End Sub

當您在瀏覽器中載入頁面時，您可以從下拉式清單中選取 [目錄 ]，以切換至目錄顯示模式。 當目錄可見時，您可以按兩下 [清單目錄][元件 ] 按鈕來示範如何 CatalogParts 存取屬性。

備註

屬性 CatalogParts 會提供區域中所有 CatalogPart 控件集合的參考。 它會參考 CatalogPart 網頁元件控件集所提供的控制項，以及新增至區域的任何自定義 CatalogPart 控件。

當另一個方法存取 CatalogParts 屬性時，就會建立集合，而 屬性會呼叫 CreateCatalogParts 方法。

注意

請注意， CatalogPart 在方法實作中新增至控件集合 CatalogPart 的任何 CreateCatalogParts 專案都必須有指派給其ID屬性的值，否則當集合指派 CatalogParts 給屬性時，將會擲回例外狀況。

另請參閱

• CatalogPartCollection
• ASP.NET 網頁元件控制件