CatalogPartCollection Constructeurs

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Initialise une nouvelle instance de la classe CatalogPartCollection.

Surcharges

CatalogPartCollection()	Initialise une nouvelle instance vide de la classe CatalogPartCollection.
CatalogPartCollection(ICollection)	Initialise une nouvelle instance d'une classe CatalogPartCollection en passant dans une collection ICollection de contrôles CatalogPart.
CatalogPartCollection(CatalogPartCollection, ICollection)	Initialise une nouvelle instance de la classe CatalogPartCollection en passant dans une collection ICollection des contrôles CatalogPart existants dans une zone, et dans une collection supplémentaire de contrôles.

Remarques

La CatalogZoneBase zone qui contient CatalogPart des contrôles est généralement le contrôle qui crée un CatalogPartCollection objet, par le biais de la CreateCatalogParts méthode . Toutefois, vous pouvez également créer votre propre CatalogPartCollection objet à d’autres fins de programmation.

CatalogPartCollection()

Initialise une nouvelle instance vide de la classe CatalogPartCollection.

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 nouvelle 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 webPart ASP.NET

CatalogPartCollection(ICollection)

Initialise une nouvelle instance d'une classe CatalogPartCollection en passant dans une collection ICollection de contrôles CatalogPart.

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

catalogParts

ICollection

ICollection de contrôles CatalogPart.

Exemples

L’exemple de code suivant montre comment créer un 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 objet CatalogPartCollection à l’aide du CatalogPartCollection constructeur . Il montre également comment vous pouvez 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 une boucle 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 . Cliquez sur le bouton Afficher les propriétés du cataloguePart pour accéder à l’objet CatalogPartCollection et affiche certaines propriétés des contrôles contenus CatalogPart . En outre, si vous placez votre pointeur de souris sur le texte de titre dans la bordure du DeclarativeCatalogPart contrôle, vous pouvez voir le nouveau texte de description qui a été ajouté au contrôle lorsque vous avez cliqué sur le bouton (la description apparaît 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.

L’un des scénarios courants d’utilisation de ce constructeur est si vous souhaitez effectuer une opération de traitement par lots sur un ensemble entier de CatalogPart contrôles, comme la modification du contenu, de l’apparence ou de la position d’un groupe d’éléments associé.

Voir aussi

• contrôles webPart ASP.NET

CatalogPartCollection(CatalogPartCollection, ICollection)

Initialise une nouvelle instance de la classe CatalogPartCollection en passant dans une collection ICollection des contrôles CatalogPart existants dans une zone, et dans une collection supplémentaire de contrôles.

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

existingCatalogParts

CatalogPartCollection

ICollection de contrôles CatalogPart existants dans une zone.

catalogParts

ICollection

ICollection de contrôles CatalogPart supplémentaires.

Voir aussi

• contrôles webPart ASP.NET