CatalogZoneBase.CatalogParts Eigenschaft

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 eine Auflistung aller CatalogPart-Steuerelemente auf, die in einer CatalogZoneBase-Zone enthalten sind.

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

Eigenschaftswert

CatalogPartCollection

Eine CatalogPartCollection, die alle einzelnen CatalogPart-Steuerelemente in einer Zone enthält.

Attribute: BrowsableAttribute

Ausnahmen

InvalidOperationException

Bei einem CatalogPart, das der Auflistung hinzugefügt wird, wurde der ID-Eigenschaft kein Wert zugewiesen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie programmgesteuert auf die CatalogParts Eigenschaft zugegriffen wird. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel der CatalogZoneBase Klassenübersicht.

Das Codebeispiel zeigt, wie Sie auf die CatalogParts -Eigenschaft zugreifen, die Auflistung durchlaufen und die IDs aller CatalogPart Steuerelemente in der Zone auflisten.

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

Wenn Sie die Seite in einem Browser laden, können Sie in der Dropdownliste Katalog auswählen, um in den Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, können Sie auf die Schaltfläche Katalogteile auflisten klicken, um zu veranschaulichen , wie auf die CatalogParts Eigenschaft zugegriffen werden kann.

Hinweise

Die CatalogParts -Eigenschaft stellt einen Verweis auf eine Auflistung aller CatalogPart Steuerelemente in der Zone bereit. Sie verweist sowohl auf die Steuerelemente, die CatalogPart mit dem Webparts-Steuerelementsatz bereitgestellt werden, als auch auf alle benutzerdefinierten CatalogPart Steuerelemente, die der Zone hinzugefügt werden.

Die Auflistung wird anfänglich erstellt, wenn eine andere Methode auf die CatalogParts -Eigenschaft zugreift, und die -Eigenschaft ruft die CreateCatalogParts -Methode auf.

Hinweis

Beachten Sie, dass alle CatalogPart , die der Auflistung von CatalogPart Steuerelementen in einer Implementierung der -Methode hinzugefügt werden, über einen Wert verfügen müssen, der CreateCatalogParts ihrer ID-Eigenschaft zugewiesen ist. Andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der CatalogParts Eigenschaft zugewiesen wird.

Gilt für:

Freigeben über