WebPartCollection.Item[] Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

Item[Int32]	Retourne 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]

Retourne un membre de la collection d'après sa position dans la collection.

public:
 property System::Web::UI::WebControls::WebParts::WebPart ^ default[int] { System::Web::UI::WebControls::WebParts::WebPart ^ get(int index); };

public System.Web.UI.WebControls.WebParts.WebPart this[int index] { get; }

member this.Item(int) : System.Web.UI.WebControls.WebParts.WebPart

Default Public ReadOnly Property Item(index As Integer) As WebPart

Paramètres

index: Int32

Index d'un contrôle WebPart particulier dans une collection.

Valeur de propriété

WebPart

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

Exemples

L’exemple de code suivant illustre l’utilisation de l’indexeur Item[] sur une page de composants WebPart. Cet exemple comporte trois parties :

Code de la page dans une classe partielle.
Page Web qui contient les contrôles.
Description du fonctionnement de l’exemple dans un navigateur.

La première partie de l’exemple de code contient le code de la page dans une classe partielle. Notez que la Button2_Click méthode crée un objet vide WebPartCollection , puis lui affecte les WebPart contrôles de la WebPartZone1.WebParts propriété . La méthode accède au premier contrôle de la collection à l’aide de son index et bascule sa Title valeur de propriété.

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class webpartcollectioncs : System.Web.UI.Page
{
  protected void Button1_Click(object sender, EventArgs e)
  {

    WebPartCollection partCollection = mgr1.WebParts;

    foreach (WebPart part in partCollection)
    {
      if (part.ChromeState != PartChromeState.Minimized)
        part.ChromeState = PartChromeState.Minimized;
      else
        part.ChromeState = PartChromeState.Normal;
    }
  }
  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartCollection partCollection = WebPartZone1.WebParts;

    if (partCollection[0].Title == "My Link List")
      partCollection[0].Title = "Favorite Links";
    else
      partCollection[0].Title = "My Link List";
  }
}

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Partial Public Class webpartcollectionvb

  Inherits System.Web.UI.Page

  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim partCollection As WebPartCollection = mgr1.WebParts
    Dim part As WebPart

    For Each part In partCollection
      If part.ChromeState <> PartChromeState.Minimized Then
        part.ChromeState = PartChromeState.Minimized
      Else
        part.ChromeState = PartChromeState.Normal
      End If
    Next

  End Sub

  Protected Sub Button2_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim partCollection As WebPartCollection = WebPartZone1.WebParts

    If partCollection(0).Title = "My Link List" Then
      partCollection(0).Title = "Favorite Links"
    Else
      partCollection(0).Title = "My Link List"
    End If

  End Sub

End Class

La deuxième partie de l’exemple de code est la page Web qui contient les contrôles. Notez que les contrôles déclarés dans WebPartZone1 sont des contrôles standard ASP.NET serveur, mais comme ils sont encapsulés en tant que GenericWebPart contrôles au moment de l’exécution et que la GenericWebPart classe hérite de la WebPart classe , les contrôles peuvent être traités comme WebPart des contrôles au moment de l’exécution et faire partie d’un WebPartCollection objet.

<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

<%@ Page Language="vb"
  Codefile="webpartcollection.vb" 
  Inherits="webpartcollectionvb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

Après avoir chargé la page dans un navigateur, cliquez sur le bouton Désactiver le titre BulletedList1 et notez que le code bascule le titre du contrôle entre les deux options de titre disponibles.

Remarques

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

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::WebPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::WebPart ^ get(System::String ^ id); };

public System.Web.UI.WebControls.WebParts.WebPart this[string id] { get; }

member this.Item(string) : System.Web.UI.WebControls.WebParts.WebPart

Default Public ReadOnly Property Item(id As String) As WebPart

Paramètres

id: String

Identificateur unique pour un contrôle WebPart particulier dans une collection.

Valeur de propriété

WebPart

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

Remarques

L’indexeur Item[] vous permet d’accéder à un WebPart contrôle dans un WebPartCollection objet en fonction d’un identificateur unique.

Notes

Le jeu de contrôles WebPart effectue une correspondance qui ne respecte pas la casse sur cette propriété. La sensibilité à la casse ne fait donc pas partie d’une valeur unique id .

La Item[] propriété permet également d’identifier les membres d’un WebPartCollection objet dans certains cas spécialisés. Dans le cas de contrôles, l’indexeur est en mesure de GenericWebPart faire correspondre l’identificateur du contrôle enfant sous-jacent encapsulé par le GenericWebPart contrôle. Dans le cas de ProxyWebPart contrôles, l’indexeur correspond à l’identificateur du contrôle en fonction d’une comparaison qui ne respecte pas la casse du id paramètre et des valeurs de propriété OriginalID ou GenericWebPartID .

Voir aussi

contrôles webPart ASP.NET

S’applique à

Partager via

WebPartCollection.Item[] Propriété

Définition

Surcharges

Item[Int32]

Paramètres

Valeur de propriété

Exemples

Remarques

Voir aussi

S’applique à

Item[String]

Paramètres

Valeur de propriété

Remarques

Voir aussi

S’applique à

Ressources supplémentaires