WebPartCollection WebPartCollection WebPartCollection WebPartCollection Class

Definition

Enthält eine Auflistung von WebPart-Steuerelementen, die zum Verfolgen und Verwalten verknüpfter Gruppen von Steuerelementen verwendet wird.Contains a collection of WebPart controls used to track and manage related groups of controls. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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
Vererbung

Beispiele

Im folgenden Codebeispiel wird die Verwendung des WebPartCollection -Objekts auf einer Webparts Seite veranschaulicht.The following code example demonstrates the use of the WebPartCollection object on a Web Parts page. Dieses Beispiel besteht aus drei Teilen:This example has three parts:

  • Der Code für die Seite in einer partiellen Klasse.The code for the page in a partial class.

  • Die Webseite, die die-Steuerelemente enthält.The Web page that contains the controls.

  • Eine Beschreibung, wie das Beispiel in einem Browser funktioniert.A description of how the example works in a browser.

Der erste Teil des Code Beispiels enthält den Code für die Seite in einer partiellen Klasse.The first part of the code example contains the code for the page in a partial class. Beachten Sie, Button1_Click dass die- WebPartCollection Methode ein-Objekt erstellt WebPart , das aus allen Steuer WebPartManager.WebParts Elementen besteht, WebPart auf die in der-Eigenschaft verwiesen wird, einschließlich aller Steuerelemente auf der Seite.Note that the Button1_Click method creates a WebPartCollection object that consists of all the WebPart controls referenced in the WebPartManager.WebParts property, which includes all the WebPart controls on the page. Die-Methode durchläuft alle-Steuerelemente und schaltet die- ChromeState Eigenschaft jedes Steuer Elements um, das bestimmt, ob dieses Steuerelement normal oder minimiert ist.The method iterates through all the controls, and toggles each control's ChromeState property, which determines whether that control is normal or minimized.

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

Der zweite Teil des Code Beispiels ist die Webseite, die die-Steuerelemente enthält.The second part of the code example is the Web page that contains the controls. Beachten Sie, dass die in WebPartZone1 deklarierten Steuerelemente standardmäßige ASP.NET-Server Steuerelemente sind GenericWebPart , aber da Sie zur Laufzeit als GenericWebPart Steuerelemente umschließt werden WebPart und die Klasse von der-Klasse erbt, werden die Steuerelemente automatisch wird zur WebPart Laufzeit als Steuerelemente behandelt und ist daher in das WebPartCollection -Objekt eingeschlossen.Notice that the controls declared in WebPartZone1 are standard ASP.NET server controls, but because they are wrapped as GenericWebPart controls at run time, and the GenericWebPart class inherits from the WebPart class, the controls are automatically treated as WebPart controls at run time and therefore are included in the 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>

Nachdem Sie die Seite in einem Browser geladen und auf die Schaltfläche ChromeState umschalten geklickt haben, durchläuft der Code in der partiellen Klasse das WebPartCollection Objekt und minimiert die Steuerelemente oder gibt Sie an normal zurück.After you load the page in a browser and click the Toggle ChromeState button, the code in the partial class loops through the WebPartCollection object and alternately minimizes the controls or returns them to normal. Wenn Sie wiederholt auf die Schaltfläche " BulletedList1 Titel umschalten " klicken, wird der Titel des obersten Steuer Elements in alternative Werte geändert.Or, if you repeatedly click the Toggle BulletedList1 Title button, the title of the uppermost control is changed to alternate values.

Hinweise

Bei WebPartCollection WebPartZoneBase WebPartManager der-Klasse handelt es sich um eine schreibgeschützte Auflistung von-Steuerelementen, die in der Regel von-und-Steuerelementen verwendet werden, WebPartThe WebPartCollection class is a read-only collection of controls, typically used by WebPartZoneBase and WebPartManager controls to manage sets of WebPart controls.

Ein WebPartManager -Steuerelement WebPartCollection verwendet ein-Objekt, um WebPart eine Liste aller Steuerelemente auf einer Seite beizubehalten WebPartZoneBase , während ein WebPartCollection -Steuerelement ein WebPart -Objekt verwendet, um die darin enthaltenen Steuerelemente nachzuverfolgen.A WebPartManager control uses a WebPartCollection object to keep a list of all the WebPart controls on a page, whereas a WebPartZoneBase control uses a WebPartCollection object to track the WebPart controls that it contains.

Hinweis

Die WebPartCollection -Auflistung enthält WebPart sowohl Steuerelemente als auch andere Server Steuerelemente (z. b. Benutzer Steuerelemente, benutzerdefinierte Steuerelemente WebPartZoneBase und ASP.NET-Steuerelemente), die in Zonen platziert und als Teil von Webparts Anwendungen verwendet werden.The WebPartCollection collection contains both WebPart controls and other server controls (such as user controls, custom controls, and ASP.NET controls) that are placed in WebPartZoneBase zones and used as part of Web Parts applications. Wenn Sie z. b. eine WebPartZone Zone in einer Seite haben und darin ein benutzerdefiniertes WebPart Steuerelement und das ASP.net Calendar -Steuerelement deklarieren, werden beide Steuerelemente WebPartCollection in der Auflistung angezeigt WebParts , auf die die-Eigenschaft verweist.So, for example, if you have a WebPartZone zone in a page, and within it you declare a custom WebPart control and the ASP.NET Calendar control, both controls will be in the WebPartCollection collection referenced by the WebParts property.

Das WebPartCollection -Objekt ist vorhanden, damit das Webparts-Steuerelement mit stark typisierten Auflistungen arbeiten kann.The WebPartCollection object exists so that the Web Parts control set can work with strongly typed collections. Wenn Sie Massen Vorgänge für einen Satz von WebPart Steuerelementen durchführen möchten, können Sie auch einen Verweis auf ein WebPartCollection -Objekt mit der WebParts -Eigenschaft erhalten.Similarly, if you want to perform mass operations on a set of WebPart controls, you can get a reference to a WebPartCollection object using the WebParts property. Beispielsweise möchten Sie möglicherweise alle WebPart Steuerelemente auf einer Seite durchlaufen und ihre Darstellung in irgendeiner Weise ändern.For example, you might want to loop through all the WebPart controls on a page and change their appearance in some way. Obwohl das WebPartCollection Objekt schreibgeschützt ist, können Sie programmgesteuerte Änderungen an den Eigenschaften der zugrunde liegenden Steuerelemente vornehmen, auf die in der Auflistung verwiesen wird.Even though the WebPartCollection object is read-only, you can make programmatic changes to the properties of the underlying controls referenced in the collection.

Konstruktoren

WebPartCollection() WebPartCollection() WebPartCollection() WebPartCollection()

Initialisiert eine neue, leere Instanz der WebPartCollection-Klasse.Initializes an empty new instance of the WebPartCollection class.

WebPartCollection(ICollection) WebPartCollection(ICollection) WebPartCollection(ICollection) WebPartCollection(ICollection)

Initialisiert eine neue Instanz eines WebPartCollection-Objekts, indem eine ICollection-Auflistung von WebPart-Steuerelementen übergeben wird.Initializes a new instance of a WebPartCollection object by passing in an ICollection collection of WebPart controls.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente ab, die in der ReadOnlyCollectionBase-Instanz enthalten sind.Gets the number of elements contained in the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf ein ReadOnlyCollectionBase-Objekt synchronisiert (threadsicher) ist.Gets a value indicating whether access to a ReadOnlyCollectionBase object is synchronized (thread safe).

(Inherited from ReadOnlyCollectionBase)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf ein ReadOnlyCollectionBase-Objekt synchronisiert werden kann.Gets an object that can be used to synchronize access to a ReadOnlyCollectionBase object.

(Inherited from ReadOnlyCollectionBase)
InnerList InnerList InnerList InnerList

Ruft die Liste der in der ReadOnlyCollectionBase-Instanz enthaltenen Elemente ab.Gets the list of elements contained in the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Gibt auf der Grundlage seiner Position in der Auflistung einen Member der Auflistung zurück.Returns a member of the collection based on its position in the collection.

Item[String] Item[String] Item[String] Item[String]

Gibt auf der Grundlage eines eindeutigen Zeichenfolgenbezeichners einen Member der Auflistung zurück.Returns a member of the collection based on a unique string identifier.

Methoden

Contains(WebPart) Contains(WebPart) Contains(WebPart) Contains(WebPart)

Ruft einen Wert ab, der angibt, ob ein bestimmtes Steuerelement in der Auflistung vorhanden ist.Returns a value indicating whether a particular control exists in the collection.

CopyTo(WebPart[], Int32) CopyTo(WebPart[], Int32) CopyTo(WebPart[], Int32) CopyTo(WebPart[], Int32)

Kopiert die Auflistung in ein Array von WebPart-Objekten.Copies the collection to an array of WebPart objects.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Enumerator zurück, der die ReadOnlyCollectionBase durchläuft.Returns an enumerator that iterates through the ReadOnlyCollectionBase instance.

(Inherited from ReadOnlyCollectionBase)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(WebPart) IndexOf(WebPart) IndexOf(WebPart) IndexOf(WebPart)

Gibt die Position eines bestimmten Members der Auflistung zurück.Returns the position of a particular member of the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Kopiert die gesamte ReadOnlyCollectionBase-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.Copies the entire ReadOnlyCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

(Inherited from ReadOnlyCollectionBase)

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch