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 控制項集合的參考。 它會參考 Web 元件控制項集所提供的控制項 CatalogPart ，以及新增至區域的任何自訂 CatalogPart 控制項。

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

注意

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

另請參閱

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