CatalogPartCollection Costruttori

Definizione

Inizializza una nuova istanza della classe CatalogPartCollection.Initializes a new instance of the CatalogPartCollection class.

Overload

CatalogPartCollection()

Inizializza una nuova istanza vuota della classe CatalogPartCollection.Initializes a new, empty instance of the CatalogPartCollection class.

CatalogPartCollection(ICollection)

Inizializza una nuova istanza della classe CatalogPartCollection passando un insieme ICollection di controlli CatalogPart.Initializes a new instance of the CatalogPartCollection class by passing in an ICollection collection of CatalogPart controls.

CatalogPartCollection(CatalogPartCollection, ICollection)

Inizializza una nuova istanza della classe CatalogPartCollection passando in un insieme ICollection dei controlli CatalogPart esistenti in una zona e in un ulteriore insieme di controlli.Initializes a new instance of the CatalogPartCollection class by passing in an ICollection collection of the existing CatalogPart controls in a zone, and an additional collection of controls.

Commenti

La CatalogZoneBase zona che contiene CatalogPart i controlli è in genere il controllo che CatalogPartCollection crea un oggetto tramite CreateCatalogParts il metodo.The CatalogZoneBase zone that contains CatalogPart controls is typically the control that creates a CatalogPartCollection object, through the CreateCatalogParts method. Tuttavia, è anche possibile creare un oggetto CatalogPartCollection personalizzato per altri scopi programmatici.However, you can also create your own CatalogPartCollection object for other programmatic purposes.

CatalogPartCollection()

Inizializza una nuova istanza vuota della classe CatalogPartCollection.Initializes a new, empty instance of the CatalogPartCollection class.

public:
 CatalogPartCollection();
public CatalogPartCollection ();
Public Sub New ()

Commenti

Il CatalogPartCollection costruttore inizializza un'istanza vuota CatalogPartCollection della classe.The CatalogPartCollection constructor initializes an empty instance of the CatalogPartCollection class. Questo overload del costruttore viene utilizzato internamente dalla CatalogZone classe CreateCatalogParts nel metodo per creare un oggetto raccolta vuoto.This overload of the constructor is used internally by the CatalogZone class in its CreateCatalogParts method to create an empty collection object. La zona crea quindi le istanze di tutti CatalogPart i controlli dichiarati nel modello di zona figlio e usa un metodo interno della raccolta per aggiungerli.The zone then creates instances of all the CatalogPart controls declared in the child zone template, and uses an internal method of the collection to add them.

Non è possibile usare questo overload del CatalogPartCollection costruttore per creare una nuova istanza di un CatalogPartCollection oggetto e CatalogPart aggiungervi controlli.You cannot use this overload of the CatalogPartCollection constructor to create a new instance of a CatalogPartCollection and add CatalogPart controls to it. In alternativa, è necessario usare uno degli altri overload per il CatalogPartCollection costruttore.You must use one of the other overloads for the CatalogPartCollection constructor instead.

Vedi anche

CatalogPartCollection(ICollection)

Inizializza una nuova istanza della classe CatalogPartCollection passando un insieme ICollection di controlli CatalogPart.Initializes a new instance of the CatalogPartCollection class by passing in an ICollection collection of CatalogPart controls.

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)

Parametri

catalogParts
ICollection

Insieme ICollection di controlli CatalogPart.An ICollection of CatalogPart controls.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come creare CatalogPartCollectionun oggetto personalizzato ed eseguire un'operazione batch per modificare CatalogPart i singoli controlli della raccolta anche se è di sola lettura.The following code example demonstrates how you can create a custom CatalogPartCollection, and perform a batch operation to change the individual CatalogPart controls in the collection even though it is read-only. Per il codice completo necessario per eseguire l'esempio, vedere la sezione relativa agli esempi CatalogPartCollection dell'argomento Panoramica della classe.For the full code required to run the example, see the Example section of the CatalogPartCollection class overview topic.

Button1_Click Il codice nel metodo crea un CatalogPart ArrayList oggetto, aggiunge i due controlli nella pagina all'oggetto, quindi crea un nuovo CatalogPartCollection oggetto usando il CatalogPartCollection costruttore.The code in the Button1_Click method creates an ArrayList object, adds the two CatalogPart controls in the page to the object, and then creates a new CatalogPartCollection object using the CatalogPartCollection constructor. Viene inoltre illustrato come è possibile apportare modifiche batch ai controlli sottostanti CatalogPart , anche se la raccolta stessa è di sola lettura.It also demonstrates how you can make batch changes to the underlying CatalogPart controls, even though the collection itself is read-only. Il codice scorre la raccolta, aggiornando la Description proprietà di ogni controllo.The code loops through the collection, updating the Description property of each control.

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 

Quando si carica la pagina in un browser, è possibile passare la pagina in modalità catalogo selezionando Catalogo nel controllo elenco a discesa modalità di visualizzazione .When you load the page in a browser, you can switch the page into catalog mode by selecting Catalog in the Display Mode drop-down list control. Facendo clic sul pulsante Visualizza Proprietà CatalogPart si accede CatalogPartCollection all'oggetto e vengono visualizzate determinate proprietà dei CatalogPart controlli contenuti.Clicking the Display CatalogPart Properties button accesses the CatalogPartCollection object and displays certain properties of the contained CatalogPart controls. Se inoltre si posiziona il puntatore del mouse sul testo del titolo all'interno del bordo del DeclarativeCatalogPart controllo, sarà possibile visualizzare il nuovo testo della descrizione aggiunto al controllo quando si fa clic sul pulsante (la descrizione viene visualizzata in una descrizione comando).Also, if you position your mouse pointer over the title text within the border of the DeclarativeCatalogPart control, you can see the new description text that was added to the control when you clicked the button (the description appears in a ToolTip). Se si fa clic sul collegamento Catalogo pagine per visualizzare PageCatalogPart il controllo, sarà presente anche una descrizione aggiornata.If you click the Page Catalog link to display the PageCatalogPart control, you will find that it also has an updated description.

Commenti

Il CatalogPartCollection costruttore inizializza un'istanza CatalogPartCollection della classe e passa una raccolta di CatalogPart controlli.The CatalogPartCollection constructor initializes an instance of the CatalogPartCollection class and passes in a collection of CatalogPart controls. Si tratta di un overload del CatalogPartCollection costruttore che è possibile usare per creare un nuovo CatalogPartCollection oggetto e aggiungervi CatalogPart controlli.This is one overload of the CatalogPartCollection constructor that you can use to create a new CatalogPartCollection object and add CatalogPart controls to it.

Anche se CatalogPartCollection l'istanza creata dal costruttore è di sola lettura, è comunque possibile accedere ai singoli CatalogPart controlli della raccolta a livello di codice e chiamarne proprietà e metodi.Although the CatalogPartCollection instance created by the constructor is read-only, you can still access the individual CatalogPart controls in the collection programmatically and call their properties and methods.

Uno scenario comune per l'utilizzo di questo costruttore è se si desidera eseguire un'operazione batch su un intero set di CatalogPart controlli, ad esempio modificando il contenuto, l'aspetto o la posizione di un gruppo correlato di elementi.One common scenario for using this constructor would be if you want to perform some batch operation on an entire set of CatalogPart controls, such as changing the content, appearance, or position of a related group of items.

Vedi anche

CatalogPartCollection(CatalogPartCollection, ICollection)

Inizializza una nuova istanza della classe CatalogPartCollection passando in un insieme ICollection dei controlli CatalogPart esistenti in una zona e in un ulteriore insieme di controlli.Initializes a new instance of the CatalogPartCollection class by passing in an ICollection collection of the existing CatalogPart controls in a zone, and an additional collection of controls.

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)

Parametri

existingCatalogParts
CatalogPartCollection

Insieme ICollection di controlli CatalogPart esistenti in una zona.An ICollection of existing CatalogPart controls in a zone.

catalogParts
ICollection

Insieme ICollection di controlli CatalogPart aggiuntivi.An ICollection of additional CatalogPart controls.

Vedi anche

Si applica a