CatalogPartCollection Konstruktory

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Inicjuje nowe wystąpienie klasy CatalogPartCollection.

Przeciążenia

CatalogPartCollection()	Inicjuje nowe, puste wystąpienie CatalogPartCollection klasy.
CatalogPartCollection(ICollection)	Inicjuje CatalogPartCollection nowe wystąpienie klasy, przekazując ICollection kolekcję CatalogPart kontrolek.
CatalogPartCollection(CatalogPartCollection, ICollection)	Inicjuje CatalogPartCollection nowe wystąpienie klasy, przekazując ICollection kolekcję istniejących CatalogPart kontrolek w strefie i dodatkową kolekcję kontrolek.

Uwagi

Strefa zawierająca CatalogZoneBaseCatalogPart kontrolki jest zazwyczaj kontrolką CatalogPartCollection , która tworzy obiekt za pomocą CreateCatalogParts metody . Można jednak również utworzyć własny CatalogPartCollection obiekt do innych celów programistycznych.

CatalogPartCollection()

Inicjuje nowe, puste wystąpienie CatalogPartCollection klasy.

public:
 CatalogPartCollection();

public CatalogPartCollection ();

Public Sub New ()

Uwagi

Konstruktor CatalogPartCollection inicjuje puste wystąpienie CatalogPartCollection klasy. To przeciążenie konstruktora jest używane wewnętrznie przez CatalogZone klasę w jej CreateCatalogParts metodzie w celu utworzenia pustego obiektu kolekcji. Następnie strefa tworzy wystąpienia wszystkich CatalogPart kontrolek zadeklarowanych w szablonie strefy podrzędnej i używa wewnętrznej metody kolekcji, aby je dodać.

Nie można użyć tego przeciążenia konstruktora CatalogPartCollection do utworzenia nowego wystąpienia obiektu CatalogPartCollection i dodania CatalogPart do niego kontrolek. Należy zamiast tego użyć jednego z innych przeciążeń konstruktora CatalogPartCollection .

Zobacz też

• kontrolki składników Web Part ASP.NET

CatalogPartCollection(ICollection)

Inicjuje CatalogPartCollection nowe wystąpienie klasy, przekazując ICollection kolekcję CatalogPart kontrolek.

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

Kontrolki ICollectionCatalogPart .

Przykłady

W poniższym przykładzie kodu pokazano, jak można utworzyć niestandardowy obiekt CatalogPartCollectioni wykonać operację wsadową, aby zmienić poszczególne CatalogPart kontrolki w kolekcji, mimo że jest tylko do odczytu. Pełny kod wymagany do uruchomienia przykładu można znaleźć w sekcji Przykład w CatalogPartCollection temacie Omówienie klasy.

Kod w metodzie Button1_Click tworzy ArrayList obiekt, dodaje dwa CatalogPart kontrolki na stronie do obiektu, a następnie tworzy nowy CatalogPartCollection obiekt przy użyciu konstruktora CatalogPartCollection . Pokazuje również, jak można wprowadzać zmiany wsadowe do podstawowych CatalogPart kontrolek, mimo że sama kolekcja jest tylko do odczytu. Kod przechodzi w pętli przez kolekcję, aktualizując Description właściwość każdej kontrolki.

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 

Po załadowaniu strony w przeglądarce możesz przełączyć stronę do trybu wykazu, wybierając pozycję Wykaz w kontrolce listy rozwijanej Tryb wyświetlania . Kliknięcie przycisku Wyświetl właściwości elementu CatalogPart powoduje uzyskanie dostępu do CatalogPartCollection obiektu i wyświetlenie niektórych właściwości zawartych CatalogPart kontrolek. Ponadto, jeśli umieścisz wskaźnik myszy nad tekstem tytułu w obramowanie DeclarativeCatalogPart kontrolki, zobaczysz nowy tekst opisu, który został dodany do kontrolki po kliknięciu przycisku (opis zostanie wyświetlony w etykietce narzędzia). Jeśli klikniesz link Wykaz stron , aby wyświetlić kontrolkę PageCatalogPart , zauważysz, że zawiera on również zaktualizowany opis.

Uwagi

Konstruktor CatalogPartCollection inicjuje CatalogPartCollection wystąpienie klasy i przekazuje kolekcję CatalogPart kontrolek. Jest to jedno przeciążenie konstruktora CatalogPartCollection , którego można użyć do utworzenia nowego CatalogPartCollection obiektu i dodania CatalogPart do niego kontrolek.

CatalogPartCollection Mimo że wystąpienie utworzone przez konstruktor jest tylko do odczytu, nadal można uzyskać dostęp do poszczególnych CatalogPart kontrolek w kolekcji programowo i wywoływać ich właściwości i metody.

Jednym z typowych scenariuszy CatalogPart użycia tego konstruktora byłoby wykonanie operacji wsadowej na całym zestawie kontrolek, takich jak zmiana zawartości, wyglądu lub pozycji powiązanej grupy elementów.

Zobacz też

• kontrolki składników Web Part ASP.NET

CatalogPartCollection(CatalogPartCollection, ICollection)

Inicjuje CatalogPartCollection nowe wystąpienie klasy, przekazując ICollection kolekcję istniejących CatalogPart kontrolek w strefie i dodatkową kolekcję kontrolek.

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

Element ICollection istniejących CatalogPart kontrolek w strefie.

catalogParts

ICollection

Dodatkowe ICollection kontrolki CatalogPart .

Zobacz też

• kontrolki składników Web Part ASP.NET