CatalogPartCollection.Item[] Eigenschaft

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.

Gibt ein bestimmtes Element der Auflistung entsprechend seiner Position oder einem eindeutigen Bezeichner zurück.

Überlädt

Name	Beschreibung
Item[Int32]	Dient zum Abrufen oder Festlegen eines Elements der Auflistung basierend auf seiner Position in der Auflistung.
Item[String]	Gibt ein Element der Auflistung basierend auf einem eindeutigen Zeichenfolgenbezeichner zurück.

Item[Int32]

Dient zum Abrufen oder Festlegen eines Elements der Auflistung basierend auf seiner Position in der Auflistung.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[int] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(int index); };

public System.Web.UI.WebControls.WebParts.CatalogPart this[int index] { get; }

member this.Item(int) : System.Web.UI.WebControls.WebParts.CatalogPart

Default Public ReadOnly Property Item(index As Integer) As CatalogPart

Parameter

index: Int32

Der Index eines bestimmten Objekts CatalogPart in der Auflistung.

Eigenschaftswert

CatalogPart

A CatalogPart am angegebenen Index in der Auflistung.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des Indexes auf ein Element eines CatalogPartCollection Objekts zugreifen können. 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 namens myParts. Beachten Sie, dass die Methode den Item[] Indexer verwendet, um Informationen aus dem ersten Element der Auflistung abzurufen.

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 " Katalog " im Dropdownlistensteuerelement " Anzeigemodus " auswählen. Durch Klicken auf die Schaltfläche " Eigenschaften anzeigen" wird auf das CatalogPartCollection Objekt zugegriffen und bestimmte Eigenschaften der enthaltenen CatalogPart Steuerelemente angezeigt. Die Anzahl der verfügbaren Serversteuerelemente innerhalb des PageCatalogPart Steuerelements wird mithilfe des Item[] Indexers in der Button1_Click Methode abgerufen.

Hinweise

Mit dem Item[] Indexer können Sie auf die zugrunde liegenden CatalogPart Steuerelemente in einem CatalogPartCollection Objekt nach Index zugreifen und deren Eigenschaftswerte oder Aufrufmethoden ändern.

Siehe auch

ASP.NET Webpart-Steuerelemente

Gilt für:

Item[String]

Gibt ein Element der Auflistung basierend auf einem eindeutigen Zeichenfolgenbezeichner zurück.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(System::String ^ id); };

public System.Web.UI.WebControls.WebParts.CatalogPart this[string id] { get; }

member this.Item(string) : System.Web.UI.WebControls.WebParts.CatalogPart

Default Public ReadOnly Property Item(id As String) As CatalogPart

Parameter

id: String

Der eindeutige Bezeichner für eine bestimmte CatalogPart Sammlung.

Eigenschaftswert

CatalogPart

Der erste CatalogPart in der Auflistung, dessen ID dem Wert von identspricht.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des Zeichenfolgen-ID-Werts auf ein Element eines CatalogPartCollection Objekts zugreifen können. 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 namens myParts. Die Methode verwendet den Item[] Indexer, um Informationen zum DeclarativeCatalogPart Steuerelement abzurufen, bei dem es sich um das zweite Element der Auflistung handelt.

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 " Katalog " im Dropdownlistensteuerelement " Anzeigemodus " auswählen. Durch Klicken auf die Schaltfläche " Eigenschaften anzeigen" wird auf das CatalogPartCollection Objekt zugegriffen und bestimmte Eigenschaften der enthaltenen CatalogPart Steuerelemente angezeigt. Die Anzahl der verfügbaren Serversteuerelemente innerhalb des DeclarativeCatalogPart Steuerelements wird mithilfe des Item[] Indexers in der Button1_Click Methode abgerufen.

Hinweise

Mit dem Item[] Indexer können Sie auf die zugrunde liegenden CatalogPart Steuerelemente in einem CatalogPartCollection Objekt zugreifen, indem Sie einen Zeichenfolgenbezeichner verwenden. Obwohl das CatalogPartCollection Objekt schreibgeschützt ist, können Sie die Eigenschaftswerte ändern oder Methoden für die zugrunde liegenden Steuerelemente aufrufen, auf die vom Indexer zugegriffen wird.

Siehe auch

ASP.NET Webpart-Steuerelemente

Gilt für:

Feedback

War diese Seite hilfreich?