CatalogPartCollection.Contains(CatalogPart) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob ein bestimmtes Steuerelement in der Auflistung vorhanden ist.

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

Parameter

catalogPart: CatalogPart

Eine CatalogPart, die überprüft wird, um zu bestimmen, ob sie in der Auflistung vorhanden ist.

Gibt zurück

Boolean

Ein boolescher Wert, der angibt, ob ein bestimmtes Steuerelement in der Auflistung vorhanden ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie feststellen können, ob ein bestimmtes CatalogPart Steuerelement mitglied eines CatalogPartCollection Objekts ist. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des CatalogPartCollection Themas Klassenübersicht.

Der Code in der Button1_Click -Methode erstellt ein neues CatalogPartCollection Objekt mit dem Namen myParts. Die -Methode verwendet die Contains -Methode, um zu bestimmen, ob das PageCatalogPart1 Steuerelement vorhanden ist, und ruft das Steuerelement ab und ändert einen Eigenschaftswert.

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

Wenn Sie die Seite in einem Browser laden, können Sie die Seite in den Katalogmodus wechseln, indem Sie im Dropdownlistensteuerelement Anzeigemodus die Option Katalog auswählen. Fügen Sie der Seite das benutzerdefinierte WebPart Steuerelement hinzu, indem Sie das Kontrollkästchen daneben aktivieren und auf Hinzufügen klicken. Klicken Sie auf Schließen , um die Seite in den Suchmodus zurückzugeben. Wenn Sie auf dem Steuerelement, das Sie gerade hinzugefügt haben, auf das Verbenmenü klicken (den Pfeil nach unten, der in der Titelleiste angezeigt wird) und dann auf Schließen klicken, wird das Steuerelement von der Seite entfernt und dem PageCatalogPart Steuerelement hinzugefügt. Kehren Sie die Seite in den Katalogmodus zurück, und klicken Sie auf den Link Seitenkatalog , um den Inhalt des Steuerelements PageCatalogPart anzuzeigen. Beachten Sie, dass das steuerelement, das Sie geschlossen haben, hinzugefügt wurde. Wenn Sie auf die Schaltfläche Katalogeigenschaften anzeigen klicken, wird auf das CatalogPartCollection Objekt zugegriffen und bestimmte Eigenschaften der enthaltenen CatalogPart Steuerelemente angezeigt. Aktivieren Sie das Kontrollkästchen neben dem im PageCatalogPart Steuerelement enthaltenen Serversteuerelement, klicken Sie auf Hinzufügen , um es der Seite wieder hinzuzufügen, und klicken Sie dann auf Schließen , um die Seite in den Suchmodus zurückzugeben. Klicken Sie im Steuerelement erneut auf das Verbenmenü, und beachten Sie, dass das Schließen-Verb jetzt weg ist. Sie wurde vom Code in der Button1_Click -Methode entfernt, als die -Methode verwendet wurde Contains , um nach zu suchen PageCatalogPart1, und dann die AllowClose -Eigenschaft auf falsefestgelegt.

Hinweise

Mit Contains der -Methode können Sie ermitteln, ob ein bestimmtes CatalogPart Objekt Teil eines CatalogPartCollection Objekts ist.

Gilt für:

Freigeben über