WebPartCollection Klas

Definitie

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

Bevat een verzameling WebPart besturingselementen die worden gebruikt voor het bijhouden en beheren van gerelateerde groepen besturingselementen. Deze klasse kan niet worden overgenomen.

public ref class WebPartCollection sealed : System::Collections::ReadOnlyCollectionBase
public sealed class WebPartCollection : System.Collections.ReadOnlyCollectionBase
type WebPartCollection = class
    inherit ReadOnlyCollectionBase
Public NotInheritable Class WebPartCollection
Inherits ReadOnlyCollectionBase
Overname
Object
ReadOnlyCollectionBase
WebPartCollection

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van het WebPartCollection object 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 en op de knop ChromeState in-/ uitschakelen hebt geklikt, loopt de code in de gedeeltelijke klasse door het WebPartCollection object en minimaliseert u de besturingselementen of retourneert deze naar normaal. 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 klasse is een alleen-lezen verzameling besturingselementen, die doorgaans worden gebruikt door WebPartZoneBase en WebPartManager besturingselementen voor het beheren van sets besturingselementen WebPart .

Een WebPartManager besturingselement gebruikt een WebPartCollection object om een lijst met alle WebPart besturingselementen op een pagina bij te houden, terwijl een WebPartZoneBase besturingselement een WebPartCollection object gebruikt om de WebPart besturingselementen bij te houden die het bevat.

Note

De verzameling WebPartCollection bevat zowel WebPart-besturingselementen als andere serverbesturingselementen (zoals gebruikersbesturingselementen, aangepaste besturingselementen en ASP.NET-besturingselementen) die in WebPartZoneBase zones worden geplaatst en worden gebruikt als onderdeel van webonderdelentoepassingen. Als u bijvoorbeeld een WebPartZone zone op een pagina hebt en binnen deze zone een aangepast WebPart besturingselement en het besturingselement ASP.NET Calendar declareert, bevinden beide besturingselementen zich in de WebPartCollection verzameling waarnaar wordt verwezen door de eigenschap WebParts.

Het WebPartCollection object bestaat zodat de besturingsset webonderdelen kan werken met sterk getypte verzamelingen. Als u massabewerkingen wilt uitvoeren op een set besturingselementen, kunt u ook een verwijzing naar een WebPartCollection object krijgen met behulp van WebPart de WebParts eigenschap. U kunt bijvoorbeeld alle WebPart besturingselementen op een pagina doorlopen en hun uiterlijk op een bepaalde manier wijzigen. Hoewel het WebPartCollection object het kenmerk Alleen-lezen heeft, kunt u programmatische wijzigingen aanbrengen in de eigenschappen van de onderliggende besturingselementen waarnaar in de verzameling wordt verwezen.

Constructors

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.

Eigenschappen

Name Description
Count

Hiermee haalt u het aantal elementen op dat in het ReadOnlyCollectionBase exemplaar is opgenomen.

(Overgenomen van ReadOnlyCollectionBase)
InnerList

Hiermee haalt u de lijst met elementen op die zijn opgenomen in het ReadOnlyCollectionBase exemplaar.

(Overgenomen van ReadOnlyCollectionBase)
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.

Methoden

Name Description
Contains(WebPart)

Retourneert een waarde die aangeeft of een bepaald besturingselement in de verzameling bestaat.
CopyTo(WebPart[], Int32)

Hiermee kopieert u de verzameling naar een matrix met WebPart objecten.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetEnumerator()

Retourneert een enumerator die door het ReadOnlyCollectionBase exemplaar wordt herhaald.

(Overgenomen van ReadOnlyCollectionBase)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
IndexOf(WebPart)

Retourneert de positie van een bepaald lid van de verzameling.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Expliciete interface-implementaties

Name Description
ICollection.CopyTo(Array, Int32)

Kopieert het hele ReadOnlyCollectionBase naar een compatibele eendimensionale Arraywaarde, beginnend bij de opgegeven index van de doelmatrix.

(Overgenomen van ReadOnlyCollectionBase)
ICollection.IsSynchronized

Hiermee wordt een waarde opgehaald die aangeeft of de toegang tot een ReadOnlyCollectionBase object wordt gesynchroniseerd (thread safe).

(Overgenomen van ReadOnlyCollectionBase)
ICollection.SyncRoot

Hiermee haalt u een object op dat kan worden gebruikt om de toegang tot een ReadOnlyCollectionBase object te synchroniseren.

(Overgenomen van ReadOnlyCollectionBase)

Extensiemethoden

Name Description
AsParallel(IEnumerable)

Hiermee schakelt u parallelle uitvoering van een query in.
AsQueryable(IEnumerable)

Converteert een IEnumerable naar een IQueryable.
Cast<TResult>(IEnumerable)

Cast de elementen van een IEnumerable naar het opgegeven type.
OfType<TResult>(IEnumerable)

Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type.

Van toepassing op

Zie ook