CatalogPartCollection.Contains(CatalogPart) 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

傳回數值，表示集合中是否存在特定控制項。

public:
 bool Contains(System::Web::UI::WebControls::WebParts::CatalogPart ^ catalogPart);
public bool Contains (System.Web.UI.WebControls.WebParts.CatalogPart catalogPart);
member this.Contains : System.Web.UI.WebControls.WebParts.CatalogPart -> bool
Public Function Contains (catalogPart As CatalogPart) As Boolean

參數

catalogPart
CatalogPart

進行檢查的 CatalogPart，以判斷是否存在於集合中。

傳回

Boolean

布林值，指出集合中是否存在特定控制項。

範例

下列程式碼範例示範如何判斷特定 CatalogPart 控制項是否為 物件的成員 CatalogPartCollection 。 如需執行範例所需的完整程式碼，請參閱類別概觀主題的 CatalogPartCollection 範例一節。

方法中的 Button1_Click 程式碼會建立名為 myParts 的新 CatalogPartCollection 物件。 方法會 Contains 使用 方法來判斷控制項是否存在 PageCatalogPart1 ，如果是，則會擷取控制項並變更屬性值。

protected void Button1_Click(object sender, EventArgs e)
{
  ArrayList list = new ArrayList(2);
  list.Add(PageCatalogPart1);
  list.Add(DeclarativeCatalogPart1);
  // Pass an ICollection object to the constructor.
  CatalogPartCollection myParts = new CatalogPartCollection(list);
  foreach (CatalogPart catalog in myParts)
  {
    catalog.Description = "My " + catalog.DisplayTitle;
  }

  // Use the IndexOf property to locate a CatalogPart control.
  int PageCatalogPartIndex = myParts.IndexOf(PageCatalogPart1);
  myParts[PageCatalogPartIndex].ChromeType = PartChromeType.TitleOnly;

  // Use the Contains method to see if a CatalogPart control exists.
  if (myParts.Contains(PageCatalogPart1))
  {
    WebPart closedWebPart = null;
    WebPartDescriptionCollection descriptions = PageCatalogPart1.GetAvailableWebPartDescriptions();
    if (descriptions.Count > 0)
    {
      closedWebPart = PageCatalogPart1.GetWebPart(descriptions[0]);
      closedWebPart.AllowClose = false;
    }
  }
  
  // Use indexers to display the details of the CatalogPart controls.
  Label1.Text = String.Empty;
  Label1.Text =
    "<h3>PageCatalogPart Details</h3>" +
    "ID: " + myParts[0].ID + "<br />" +
    "Count: " + myParts[0].GetAvailableWebPartDescriptions().Count;
  Label1.Text += 
    "<h3>DeclarativeCatalogPart Details</h3>" +
    "ID: " + myParts["DeclarativeCatalogPart1"].ID + "<br />" +
    "Count: " + myParts["DeclarativeCatalogPart1"].GetAvailableWebPartDescriptions().Count;
}

Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) 
    Dim list As New ArrayList(2)
    list.Add(PageCatalogPart1)
    list.Add(DeclarativeCatalogPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New CatalogPartCollection(list)
    Dim catalog As CatalogPart
    For Each catalog In  myParts
        catalog.Description = "My " + catalog.DisplayTitle
    Next catalog
    
    ' Use the IndexOf property to locate a CatalogPart control.
    Dim PageCatalogPartIndex As Integer = _
      myParts.IndexOf(PageCatalogPart1)
    myParts(PageCatalogPartIndex).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if a CatalogPart control exists.
    If myParts.Contains(PageCatalogPart1) Then
        Dim closedWebPart As WebPart = Nothing
        Dim descriptions As WebPartDescriptionCollection = _
          PageCatalogPart1.GetAvailableWebPartDescriptions()
        If descriptions.Count > 0 Then
            closedWebPart = PageCatalogPart1.GetWebPart(descriptions(0))
            closedWebPart.AllowClose = False
        End If
    End If
    
    ' Use indexers to display the details of the CatalogPart controls.
    Label1.Text = String.Empty
    Label1.Text = _
      "<h3>PageCatalogPart Details</h3>" & _
      "ID: " & myParts(0).ID + "<br />" & _
      "Count: " & myParts(0).GetAvailableWebPartDescriptions().Count
    Label1.Text += _
      "<h3>DeclarativeCatalogPart Details</h3>" & _
      "ID: " & myParts("DeclarativeCatalogPart1").ID & "<br />" & _
      "Count: " & myParts("DeclarativeCatalogPart1") _
        .GetAvailableWebPartDescriptions().Count

End Sub

當您在瀏覽器中載入頁面時，您可以在 [顯示模式] 下拉式清單控制項中選取 [目錄]，將頁面切換為目錄模式。 選取頁面旁邊的核取方塊，然後按一下 [新增]，將自訂 WebPart 控制項新增至頁面。 按一下 [關閉 ] 以傳回頁面以瀏覽模式。 在您剛才新增的控制項上，如果您按一下動詞功能表， (標題列中出現的向下箭號) 然後按一下 [ 關閉]，控制項就會從頁面移除並新增至 PageCatalogPart 控制項。 將頁面傳回目錄模式，然後按一下 [頁面目錄] 連結以檢視控制項的內容 PageCatalogPart 。 請注意，您關閉的控制項已新增至其中。 按一下 [ 顯示 CatalogPart 屬性 ] 按鈕會存取物件， CatalogPartCollection 並顯示包含 CatalogPart 控制項的特定屬性。 選取控制項中包含的 PageCatalogPart 伺服器控制項旁的核取方塊，按一下 [ 新增 ] 將它新增回頁面，然後按一下 [ 關閉 ] 以傳回頁面以瀏覽模式。 再次在控制項上按一下動詞功能表，並請注意，現在關閉動詞已消失。 當方法使用 Contains 方法來檢查 PageCatalogPart1 時，方法中的 Button1_Click 程式碼會移除它，然後將其 屬性設定 AllowClose 為 false 。

備註

方法 Contains 可讓您判斷特定 CatalogPart 物件是否為 物件的一 CatalogPartCollection 部分。

適用於

另請參閱