CatalogPartCollection Constructors

public:
 CatalogPartCollection();

public CatalogPartCollection();

Public Sub New ()

Opmerkingen

De CatalogPartCollection constructor initialiseert een leeg exemplaar van de CatalogPartCollection klasse. Deze overbelasting van de constructor wordt intern door de klasse gebruikt in de CatalogZoneCreateCatalogParts methode om een leeg verzamelingsobject te maken. De zone maakt vervolgens exemplaren van alle CatalogPart besturingselementen die zijn gedeclareerd in de onderliggende zonesjabloon en maakt gebruik van een interne methode van de verzameling om deze toe te voegen.

U kunt deze overbelasting van de CatalogPartCollection constructor niet gebruiken om een nieuw exemplaar van een CatalogPartCollection te maken en besturingselementen eraan toe te voegen CatalogPart . U moet in plaats daarvan een van de andere overbelastingen voor de CatalogPartCollection constructor gebruiken.

Zie ook

• ASP.NET besturingselementen voor webonderdelen

public:
 CatalogPartCollection(System::Collections::ICollection ^ catalogParts);

public CatalogPartCollection(System.Collections.ICollection catalogParts);

new System.Web.UI.WebControls.WebParts.CatalogPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.CatalogPartCollection

Public Sub New (catalogParts As ICollection)

Parameters

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een aangepaste CatalogPartCollectionbewerking kunt maken en een batchbewerking kunt uitvoeren om de afzonderlijke CatalogPart besturingselementen in de verzameling te wijzigen, ook al is deze alleen-lezen. Zie de sectie Voorbeeld van het CatalogPartCollection onderwerp Class Overview voor de volledige code die is vereist om het voorbeeld uit te voeren.

De code in de Button1_Click methode maakt een ArrayList object, voegt de twee CatalogPart besturingselementen op de pagina toe aan het object en maakt vervolgens een nieuw CatalogPartCollection object met behulp van de CatalogPartCollection constructor. Ook ziet u hoe u batchwijzigingen kunt aanbrengen in de onderliggende CatalogPart besturingselementen, ook al is de verzameling zelf alleen-lezen. De code doorloopt de verzameling, waarbij de Description eigenschap van elk besturingselement wordt bijgewerkt.

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 

Wanneer u de pagina in een browser laadt, kunt u de pagina overschakelen naar de catalogusmodus door Catalogus te selecteren in de vervolgkeuzelijst Weergavemodus . Als u op de knop Eigenschappen van CatalogPart weergeven klikt, wordt het CatalogPartCollection object geopend en worden bepaalde eigenschappen van de ingesloten CatalogPart besturingselementen weergegeven. Als u de muisaanwijzer op de titeltekst in de rand van het DeclarativeCatalogPart besturingselement plaatst, ziet u ook de nieuwe beschrijvingstekst die aan het besturingselement is toegevoegd toen u op de knop hebt geklikt (de beschrijving wordt weergegeven in knopinfo). Als u op de koppeling Paginacatalogus klikt om het PageCatalogPart besturingselement weer te geven, zult u merken dat het ook een bijgewerkte beschrijving heeft.

Opmerkingen

De CatalogPartCollection constructor initialiseert een exemplaar van de CatalogPartCollection klasse en geeft een verzameling CatalogPart besturingselementen door. Dit is een overbelasting van de CatalogPartCollection constructor die u kunt gebruiken om een nieuw CatalogPartCollection object te maken en besturingselementen eraan toe te voegen CatalogPart .

Hoewel het CatalogPartCollection exemplaar dat door de constructor is gemaakt, alleen-lezen is, hebt u nog steeds via programmacode toegang tot de afzonderlijke CatalogPart besturingselementen in de verzameling en kunt u de bijbehorende eigenschappen en methoden aanroepen.

Een veelvoorkomend scenario voor het gebruik van deze constructor is als u een batchbewerking wilt uitvoeren op een hele set besturingselementen, zoals het wijzigen van CatalogPart de inhoud, het uiterlijk of de positie van een gerelateerde groep items.

Zie ook

• ASP.NET besturingselementen voor webonderdelen

public:
 CatalogPartCollection(System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ existingCatalogParts, System::Collections::ICollection ^ catalogParts);

public CatalogPartCollection(System.Web.UI.WebControls.WebParts.CatalogPartCollection existingCatalogParts, System.Collections.ICollection catalogParts);

new System.Web.UI.WebControls.WebParts.CatalogPartCollection : System.Web.UI.WebControls.WebParts.CatalogPartCollection * System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.CatalogPartCollection

Public Sub New (existingCatalogParts As CatalogPartCollection, catalogParts As ICollection)

Parameters

Zie ook

• ASP.NET besturingselementen voor webonderdelen