WebPartCollection.Item[] Eigenschap

Definitie

Naamruimte:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een specifiek lid van de verzameling op basis van de positie of een unieke id.

Overloads

Name	Description
Item[Int32]	Retourneert een lid van de verzameling op basis van de positie in de verzameling.
Item[String]	Retourneert een lid van de verzameling op basis van een unieke tekenreeks-id.

Item[Int32]

Retourneert een lid van de verzameling op basis van de positie in de verzameling.

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

Parameters

index: Int32

De index van een bepaald WebPart besturingselement in een verzameling.

Waarde van eigenschap

WebPart

Een WebPart bij de opgegeven index in de verzameling.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe de Item[] indexeerfunctie op een pagina met webonderdelen wordt gebruikt. In dit voorbeeld zijn drie delen:

De code voor de pagina in een gedeeltelijke klasse.
De webpagina met de besturingselementen.
Een beschrijving van de werking van het voorbeeld in een browser.

Het eerste deel van het codevoorbeeld bevat de code voor de pagina in een gedeeltelijke klasse. Houd er rekening mee dat met de Button2_Click methode een leeg WebPartCollection object wordt gemaakt en vervolgens de WebPart besturingselementen van de WebPartZone1.WebParts eigenschap worden toegewezen. De methode opent het eerste besturingselement in de verzameling met behulp van de index en schakelt de Title eigenschapswaarde in.

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

Het tweede deel van het codevoorbeeld is de webpagina die de besturingselementen bevat. U ziet dat de besturingselementen die zijn gedeclareerd in WebPartZone1 standaard ASP.NET serverbesturingselementen zijn, maar omdat ze zijn verpakt als GenericWebPart besturingselementen tijdens runtime en de GenericWebPart-klasse wordt overgenomen van de klasse WebPart, kunnen de besturingselementen worden behandeld als WebPart-besturingselementen tijdens uitvoering en deel uitmaken van een WebPartCollection-object.

<%@ 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>

Nadat u de pagina in een browser hebt geladen, klikt u op de knop Opsommingstekenlijst1-titel in-/uitschakelen en ziet u dat de code de titel van het besturingselement tussen de twee beschikbare titelkeuzes wijzigt.

Opmerkingen

Met Item[] de indexeerfunctie kunt u toegang krijgen tot de onderliggende WebPart besturingselementen in een WebPartCollection object per index en de bijbehorende eigenschapswaarden of aanroepmethoden wijzigen.

Zie ook

Van toepassing op

Item[String]

Retourneert een lid van de verzameling op basis van een unieke tekenreeks-id.

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

Parameters

id: String

De unieke id voor een bepaald WebPart besturingselement in een verzameling.

Waarde van eigenschap

WebPart

De eerste WebPart in de verzameling waarvan de id gelijk is aan de waarde van id.

Opmerkingen

Met Item[] de indexeerfunctie kunt u toegang krijgen tot een WebPart besturingselement in een WebPartCollection object op basis van een unieke id.

Note

De besturingsset webonderdelen voert hoofdlettergevoelige overeenkomsten uit op deze eigenschap, dus hoofdlettergevoeligheid maakt geen deel uit van een unieke id waarde.

De Item[] eigenschap werkt ook om leden van een WebPartCollection object in sommige gespecialiseerde gevallen te identificeren. In het geval van GenericWebPart besturingselementen kan de indexeerfunctie overeenkomen met de id voor het onderliggende onderliggende besturingselement dat door het GenericWebPart besturingselement is verpakt. In het geval van ProxyWebPart besturingselementen komt de indexeerfunctie overeen met de id voor het besturingselement op basis van een niet-hoofdlettergevoelige vergelijking van de id parameter en ofwel de OriginalID eigenschapswaarden GenericWebPartID .

Zie ook

ASP.NET besturingselementen voor webonderdelen

Van toepassing op

Feedback

Is deze pagina nuttig?