WebPartCollection Constructors

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.

Initialiseert een nieuw exemplaar van de WebPartCollection klasse.

Overloads

Name	Description
WebPartCollection()	Initialiseert een leeg nieuw exemplaar van de WebPartCollection klasse.
WebPartCollection(ICollection)	Initialiseert een nieuw exemplaar van een WebPartCollection object door een ICollection verzameling WebPart besturingselementen door te geven.

WebPartCollection()

Initialiseert een leeg nieuw exemplaar van de WebPartCollection klasse.

public:
 WebPartCollection();

public WebPartCollection();

Public Sub New ()

Opmerkingen

De WebPartCollection constructor initialiseert een leeg exemplaar van de WebPartCollection klasse. Het object zelf heeft het kenmerk Alleen-lezen en heeft geen methode om afzonderlijke WebPart besturingselementen eraan toe te voegen. Daarom hebt u weinig gelegenheid om deze constructor te gebruiken.

Zie ook

ASP.NET besturingselementen voor webonderdelen

Van toepassing op

WebPartCollection(ICollection)

Initialiseert een nieuw exemplaar van een WebPartCollection object door een ICollection verzameling WebPart besturingselementen door te geven.

public:
 WebPartCollection(System::Collections::ICollection ^ webParts);

public WebPartCollection(System.Collections.ICollection webParts);

new System.Web.UI.WebControls.WebParts.WebPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartCollection

Public Sub New (webParts As ICollection)

Parameters

webParts: ICollection

Een ICollection van WebPart de besturingselementen.

Uitzonderingen

ArgumentNullException

webParts is null.

ArgumentException

Een object in de webParts verzameling is null.

– of –

Een object in de webParts verzameling is geen type WebPart.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de WebPartCollection constructor op een pagina met webonderdelen. 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 de Button1_Click methode een WebPartCollection object maakt dat bestaat uit alle WebPart besturingselementen waarnaar wordt verwezen in de WebPartManager.WebParts eigenschap, die alle WebPart besturingselementen op de pagina bevat. De methode doorloopt alle besturingselementen en schakelt de eigenschap van ChromeState elk besturingselement in, die bepaalt of dat besturingselement normaal of geminimaliseerd is.

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 neemt over van de klasse WebPart, worden de besturingselementen automatisch behandeld als WebPart-besturingselementen tijdens runtime en daarom zijn opgenomen in het 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 ChromeState in-/ uitschakelen en ziet u dat de code in de gedeeltelijke klasse door het WebPartCollection object loopt en dat de besturingselementen worden geminimaliseerd of weer normaal worden weergegeven. Of als u herhaaldelijk op de knop Opsommingstekenlijst1 titel in- /uitschakelen klikt, wordt de titel van het bovenste besturingselement gewijzigd in alternatieve waarden.

Opmerkingen

De WebPartCollection constructor initialiseert een exemplaar van de WebPartCollection klasse door een verzameling WebPart besturingselementen door te geven.

Hoewel een WebPartCollection object alleen-lezen is en er geen methode is voor het toevoegen van afzonderlijke besturingselementen, kunt u uw eigen ICollection verzameling besturingselementen maken en dit doorgeven aan de WebPartCollection constructor. Hiermee kunt u aangepaste verzamelingen maken en bulkbewerkingen uitvoeren. U kunt ook toegang krijgen tot de onderliggende besturingselementen in de verzameling en hun eigenschapswaarden programmatisch wijzigen.

Zie ook

ASP.NET besturingselementen voor webonderdelen

Van toepassing op

Feedback

Is deze pagina nuttig?