Share via

CatalogPartCollection.Item[] Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Retourne un membre spécifique de la collection d'après sa position ou un identificateur unique.

Surcharges

Item[Int32]

Obtient ou définit un membre de la collection d'après sa position dans la collection.
Item[String]

Retourne un membre de la collection d'après son identificateur de chaîne unique.

Item[Int32]

Obtient ou définit un membre de la collection d'après sa position dans la collection.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[int] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(int index); };
public System.Web.UI.WebControls.WebParts.CatalogPart this[int index] { get; }
member this.Item(int) : System.Web.UI.WebControls.WebParts.CatalogPart
Default Public ReadOnly Property Item(index As Integer) As CatalogPart

Paramètres

index
Int32

Index d'un CatalogPart particulier dans la collection.

Valeur de propriété

CatalogPart

CatalogPart à l'index spécifié dans la collection.

Exemples

L’exemple de code suivant montre comment accéder à un membre d’un CatalogPartCollection objet à l’aide de son index. 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 objet CatalogPartCollection nommé myParts. Notez que la méthode utilise l’indexeur Item[] pour récupérer des informations du premier membre de la collection.

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 catalogPart , accédez à l’objet CatalogPartCollection et affiche certaines propriétés des contrôles contenus CatalogPart . Le nombre de contrôles serveur disponibles au sein du PageCatalogPart contrôle est obtenu à l’aide de l’indexeur Item[] dans la Button1_Click méthode.

Remarques

L’indexeur Item[] vous permet d’accéder aux contrôles sous-jacents CatalogPart d’un CatalogPartCollection objet par index et de modifier leurs valeurs de propriété ou méthodes d’appel.

Voir aussi

S’applique à

Item[String]

Retourne un membre de la collection d'après son identificateur de chaîne unique.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(System::String ^ id); };
public System.Web.UI.WebControls.WebParts.CatalogPart this[string id] { get; }
member this.Item(string) : System.Web.UI.WebControls.WebParts.CatalogPart
Default Public ReadOnly Property Item(id As String) As CatalogPart

Paramètres

id
String

Identificateur unique pour un CatalogPart particulier dans une collection.

Valeur de propriété

CatalogPart

Premier CatalogPart de la collection dont l'ID est égal à la valeur de id.

Exemples

L’exemple de code suivant montre comment accéder à un membre d’un CatalogPartCollection objet à l’aide de sa valeur d’ID de chaîne. 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 objet CatalogPartCollection nommé myParts. La méthode utilise l’indexeur Item[] pour récupérer des informations sur le DeclarativeCatalogPart contrôle, qui est le deuxième membre de la collection.

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 catalogPart , accédez à l’objet CatalogPartCollection et affiche certaines propriétés des contrôles contenus CatalogPart . Le nombre de contrôles serveur disponibles au sein du DeclarativeCatalogPart contrôle est obtenu à l’aide de l’indexeur Item[] dans la Button1_Click méthode.

Remarques

L’indexeur Item[] vous permet d’accéder aux contrôles sous-jacents CatalogPart dans un CatalogPartCollection objet à l’aide d’un identificateur de chaîne. Bien que l’objet CatalogPartCollection soit en lecture seule, vous pouvez modifier les valeurs de propriété ou les méthodes d’appel sur les contrôles sous-jacents accessibles par l’indexeur.

Voir aussi

S’applique à