CatalogPartCollection Constructeurs

public:
 CatalogPartCollection();

public CatalogPartCollection ();

Public Sub New ()

Remarques

Le CatalogPartCollection constructeur initialise une instance vide de la CatalogPartCollection classe. Cette surcharge du constructeur est utilisée en interne par la CatalogZone classe dans sa CreateCatalogParts méthode pour créer un objet de collection vide. La zone crée ensuite des instances de tous les CatalogPart contrôles déclarés dans le modèle de zone enfant et utilise une méthode interne de la collection pour les ajouter.

Vous ne pouvez pas utiliser cette surcharge du CatalogPartCollection constructeur pour créer une instance d’un CatalogPartCollection et y ajouter CatalogPart des contrôles. Vous devez utiliser l’une des autres surcharges pour le constructeur à la CatalogPartCollection place.

Voir aussi

• contrôles de composants WebPart ASP.NET

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)

Paramètres

Exemples

L’exemple de code suivant montre comment créer un objet personnalisé CatalogPartCollectionet effectuer une opération de traitement par lots pour modifier les contrôles individuels CatalogPart dans la collection, même si elle est en lecture seule. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la rubrique Vue d’ensemble de la CatalogPartCollection classe.

Le code de la Button1_Click méthode crée un ArrayList objet, ajoute les deux CatalogPart contrôles de la page à l’objet, puis crée un nouvel CatalogPartCollection objet à l’aide du CatalogPartCollection constructeur. Il montre également comment apporter des modifications par lot aux contrôles sous-jacents CatalogPart , même si la collection elle-même est en lecture seule. Le code effectue des boucles dans la collection, mettant à jour la Description propriété de chaque contrôle.

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 

Lorsque vous chargez la page dans un navigateur, vous pouvez basculer la page en mode catalogue en sélectionnant Catalogue dans le contrôle de liste déroulante Mode d’affichage . En cliquant sur le bouton Afficher les propriétés du cataloguePart , vous accédez à l’objet CatalogPartCollection et affiche certaines propriétés des contrôles contenus CatalogPart . En outre, si vous positionnez votre pointeur de souris sur le texte de titre dans la DeclarativeCatalogPart bordure du contrôle, vous pouvez voir le nouveau texte de description ajouté au contrôle lorsque vous avez cliqué sur le bouton (la description s’affiche dans une info-bulle). Si vous cliquez sur le lien Catalogue de pages pour afficher le PageCatalogPart contrôle, vous constaterez qu’il a également une description mise à jour.

Remarques

Le CatalogPartCollection constructeur initialise une instance de la CatalogPartCollection classe et transmet une collection de CatalogPart contrôles. Il s’agit d’une surcharge du CatalogPartCollection constructeur que vous pouvez utiliser pour créer un CatalogPartCollection objet et y ajouter CatalogPart des contrôles.

Bien que l’instance CatalogPartCollection créée par le constructeur soit en lecture seule, vous pouvez toujours accéder aux contrôles individuels CatalogPart de la collection par programmation et appeler leurs propriétés et méthodes.

Un scénario courant pour l’utilisation de ce constructeur consiste à effectuer une opération par lots sur un ensemble entier de contrôles, comme la modification du contenu, de CatalogPart l’apparence ou de la position d’un groupe d’éléments associé.

Voir aussi

• contrôles de composants WebPart ASP.NET

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)

Paramètres

Voir aussi

• contrôles de composants WebPart ASP.NET