CatalogZoneBase.CatalogParts Eigenschaft
Definition
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.CatalogPartCollectionPublic ReadOnly Property CatalogParts As CatalogPartCollectionEigenschaftswert
Eine CatalogPartCollection, die alle einzelnen CatalogPart-Steuerelemente in einer Zone enthält.
- Attribute
Ausnahmen
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.
