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 sie programmgesteuert auf die CatalogParts Eigenschaft zugreifen. 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 " Katalog " aus der Dropdownliste auswählen, um zum Kataloganzeigemodus zu wechseln. Wenn der Katalog sichtbar ist, können Sie auf die Schaltfläche "List CatalogParts " 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. Es verweist sowohl auf die CatalogPart Steuerelemente, die mit dem steuerelementsatz Webparts bereitgestellt werden, als auch auf alle benutzerdefinierten CatalogPart Steuerelemente, die der Zone hinzugefügt werden.

Die Auflistung wird zunächst erstellt, wenn eine andere Methode auf die CatalogParts Eigenschaft zugreift, und die Eigenschaft ruft die CreateCatalogParts Methode auf.

Hinweis

Beachten Sie, dass jeder CatalogPart , der der Auflistung von CatalogPart Steuerelementen in einer Implementierung der Methode hinzugefügt wird, einen Wert aufweisen muss, der CreateCatalogParts der ID-Eigenschaft zugewiesen ist, andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der CatalogParts Eigenschaft zugewiesen wird.

Gilt für

Share via