CatalogPartCollection Konstruktory

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Inicializuje novou instanci CatalogPartCollection třídy.

Přetížení

CatalogPartCollection()	Inicializuje novou prázdnou CatalogPartCollection instanci třídy.
CatalogPartCollection(ICollection)	Inicializuje novou instanci CatalogPartCollection třídy předáním ICollection kolekce ovládacích CatalogPart prvků.
CatalogPartCollection(CatalogPartCollection, ICollection)	Inicializuje novou instanci CatalogPartCollection třídy předáním ICollection kolekce existujících CatalogPart ovládacích prvků v zóně a další kolekce ovládacích prvků.

Poznámky

Zóna CatalogZoneBase , která obsahuje CatalogPart ovládací prvky, je obvykle ovládací prvek, který vytváří CatalogPartCollection objekt prostřednictvím CreateCatalogParts metody . Můžete ale také vytvořit vlastní CatalogPartCollection objekt pro jiné programové účely.

CatalogPartCollection()

Inicializuje novou prázdnou CatalogPartCollection instanci třídy.

public:
 CatalogPartCollection();

public CatalogPartCollection ();

Public Sub New ()

Poznámky

Konstruktor CatalogPartCollection inicializuje prázdnou CatalogPartCollection instanci třídy. Toto přetížení konstruktoru interně CatalogZone používá třída ve své CreateCatalogParts metodě k vytvoření prázdného objektu kolekce. Zóna pak vytvoří instance všech CatalogPart ovládacích prvků deklarovaných v šabloně podřízené zóny a pomocí interní metody kolekce je přidá.

Toto přetížení konstruktoru CatalogPartCollection nelze použít k vytvoření nové instance objektu CatalogPartCollection a přidání CatalogPart ovládacích prvků do ní. Místo toho musíte pro konstruktor použít jedno z dalších přetížení CatalogPartCollection .

Viz také

• ASP.NET ovládací prvky webových částí

CatalogPartCollection(ICollection)

Inicializuje novou instanci CatalogPartCollection třídy předáním ICollection kolekce ovládacích CatalogPart prvků.

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)

Parametry

catalogParts

ICollection

Funkce ICollection ovládacích CatalogPart prvků.

Příklady

Následující příklad kódu ukazuje, jak můžete vytvořit vlastní CatalogPartCollectiona provést dávkovou operaci ke změně jednotlivých CatalogPart ovládacích prvků v kolekci, i když je jen pro čtení. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v tématu přehledu CatalogPartCollection třídy.

Kód v Button1_Click metodě vytvoří ArrayList objekt, přidá dva CatalogPart ovládací prvky na stránce do objektu a pak vytvoří nový CatalogPartCollection objekt pomocí konstruktoru CatalogPartCollection . Ukazuje také, jak můžete provádět dávkové změny podkladových ovládacích CatalogPart prvků, i když samotná kolekce je jen pro čtení. Kód prochází kolekcí a aktualizuje Description vlastnost každého ovládacího prvku.

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 

Když stránku načtete v prohlížeči, můžete ji přepnout do režimu katalogu tak, že v ovládacím prvku rozevíracího seznamu Režim zobrazení vyberete Katalog. Kliknutím na tlačítko Zobrazit katalogSoučásti vlastnosti se dostanete k objektu CatalogPartCollection a zobrazíte určité vlastnosti obsažených CatalogPart ovládacích prvků. Pokud umístíte ukazatel myši na text nadpisu v rámci ohraničení DeclarativeCatalogPart ovládacího prvku, uvidíte nový text popisu, který byl přidán do ovládacího prvku po kliknutí na tlačítko (popis se zobrazí v popisku). Pokud ovládací prvek zobrazíte PageCatalogPart kliknutím na odkaz Katalog stránek, zjistíte, že má také aktualizovaný popis.

Poznámky

Konstruktor CatalogPartCollection inicializuje instanci CatalogPartCollection třídy a předává kolekci ovládacích CatalogPart prvků. Toto je jedno přetížení konstruktoru CatalogPartCollection , které můžete použít k vytvoření nového CatalogPartCollection objektu a přidání CatalogPart ovládacích prvků do něj.

CatalogPartCollection Přestože instance vytvořená konstruktorem je jen pro čtení, stále můžete přistupovat k jednotlivým CatalogPart ovládacím prvkům v kolekci programově a volat jejich vlastnosti a metody.

Jedním z běžných scénářů použití tohoto konstruktoru by bylo, pokud chcete provést nějakou dávkovou operaci s celou sadou ovládacích CatalogPart prvků, jako je například změna obsahu, vzhledu nebo umístění související skupiny položek.

Viz také

• ASP.NET ovládací prvky webových částí

CatalogPartCollection(CatalogPartCollection, ICollection)

Inicializuje novou instanci CatalogPartCollection třídy předáním ICollection kolekce existujících CatalogPart ovládacích prvků v zóně a další kolekce ovládacích prvků.

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)

Parametry

existingCatalogParts

CatalogPartCollection

An ICollection ze stávajících CatalogPart ovládacích prvků v zóně.

catalogParts

ICollection

A ICollection dalších CatalogPart ovládacích prvků.

Viz také

• ASP.NET ovládací prvky webových částí