Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

WebPartCollection-Klasse

 

Veröffentlicht: Oktober 2016

Enthält eine Auflistung von WebPart-Steuerelementen, die zum Nachverfolgen und Verwalten verwandter Gruppen von Steuerelementen verwendet wird. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Collections.ReadOnlyCollectionBase
    System.Web.UI.WebControls.WebParts.WebPartCollection

public sealed class WebPartCollection : ReadOnlyCollectionBase

NameBeschreibung
System_CAPS_pubmethodWebPartCollection()

Initialisiert eine neue, leere Instanz von der WebPartCollection Klasse.

System_CAPS_pubmethodWebPartCollection(ICollection)

Initialisiert eine neue Instanz der ein WebPartCollection Objekt durch Übergabe einer ICollection Auflistung von WebPart Steuerelemente.

NameBeschreibung
System_CAPS_pubpropertyCount

Ruft die Anzahl der Elemente ab, die in der ReadOnlyCollectionBase-Instanz enthalten sind.(Geerbt von „ReadOnlyCollectionBase“.)

System_CAPS_pubpropertyItem[Int32]

Gibt einen Member der Auflistung anhand seiner Position in der Auflistung zurück.

System_CAPS_pubpropertyItem[String]

Gibt ein Element der Auflistung basierend auf einen eindeutigen Zeichenfolgenbezeichner zurück.

NameBeschreibung
System_CAPS_pubmethodContains(WebPart)

Gibt einen Wert, der angibt, ob ein bestimmtes Steuerelement in der Auflistung vorhanden ist.

System_CAPS_pubmethodCopyTo(WebPart[], Int32)

Kopiert die Auflistung in ein Array von WebPart Objekte.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetEnumerator()

Gibt einen Enumerator, der durchläuft die ReadOnlyCollectionBase Instanz.(Geerbt von „ReadOnlyCollectionBase“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIndexOf(WebPart)

Gibt die Position eines bestimmten Members der Auflistung zurück.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Kopiert die gesamte ReadOnlyCollectionBase-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.(Geerbt von „ReadOnlyCollectionBase“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf ein ReadOnlyCollectionBase-Objekt synchronisiert (threadsicher) ist.(Geerbt von „ReadOnlyCollectionBase“.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf ein ReadOnlyCollectionBase-Objekt synchronisiert werden kann.(Geerbt von „ReadOnlyCollectionBase“.)

NameBeschreibung
System_CAPS_pubmethodAsParallel()

Überladen. Ermöglicht die Parallelisierung einer Abfrage.(Definiert durch ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Überladen. Konvertiert ein IEnumerable zu einer IQueryable.(Definiert durch Queryable.)

System_CAPS_pubmethodCast<TResult>()

Wandelt die Elemente einer IEnumerable in den angegebenen Typ.(Definiert durch Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtert die Elemente einer IEnumerable auf Grundlage eines angegebenen Typs.(Definiert durch Enumerable.)

Die WebPartCollection -Klasse ist eine schreibgeschützte Auflistung von Steuerelementen, die meist von WebPartZoneBase und WebPartManager Steuerelemente zum Verwalten von Gruppen von WebPart Steuerelemente.

Ein WebPartManager -Steuerelement verwendet ein WebPartCollection Objekt, das eine Liste aller der WebPart Steuerelemente auf einer Seite, während ein WebPartZoneBase -Steuerelement verwendet eine WebPartCollection zu verfolgende Objekt die WebPart die darin enthaltenen Steuerelemente.

System_CAPS_noteHinweis

Die WebPartCollection -Auflistung enthält sowohl WebPart und andere Serversteuerelemente (z. B. Benutzersteuerelemente, benutzerdefinierte Steuerelemente und ASP.NET-Steuerelemente), die in platziert werden WebPartZoneBase Zonen und als Teil des Webparts-Anwendung verwendet. Z. B. Wenn Sie also eine WebPartZone zone auf einer Seite, und darin, die Sie Deklarieren einer benutzerdefiniertes WebPart -Steuerelement und das ASP.NET Calendar -Steuerelement, werden beide Steuerelemente in der WebPartCollection Auflistung, auf die WebParts Eigenschaft.

Das WebPartCollection Objekt vorhanden, sodass der Webparts-Steuerelementsatz mit stark typisierten Auflistungen arbeiten kann. Auf ähnliche Weise, wenn Sie für einen Satz von Massenvorgänge ausführen möchten WebPart Steuerelemente, erhalten Sie einen Verweis auf eine WebPartCollection -Objekt mithilfe der WebParts Eigenschaft. Beispielsweise möchten Sie durchlaufen alle die WebPart Steuerelemente auf einer Seite und deren Darstellung in irgendeiner Weise verändern. Obwohl die WebPartCollection Objekt schreibgeschützt ist, können Sie programmgesteuerte Änderungen an den Eigenschaften der zugrunde liegenden Steuerelemente in der Auflistung verwiesen wird.

Das folgende Codebeispiel veranschaulicht die Verwendung der WebPartCollection Objekt auf einer Webparts-Seite. In diesem Beispiel besteht aus drei Teilen:

  • Der Code für die Seite in einer partiellen Klasse.

  • Die Webseite, die die Steuerelemente enthält.

  • Eine Beschreibung der Funktionsweise des Beispiels in einem Browser.

Der erste Teil des Codebeispiels enthält den Code für die Seite in einer partiellen Klasse. Beachten Sie, dass die Button1_Click -Methode erstellt ein WebPartCollection -Objekt, das alle besteht die WebPart Steuerelemente, die in der die WebPartManager.WebParts -Eigenschaft, die alle die WebPart Steuerelemente auf der Seite. Die Methode durchläuft alle Steuerelemente und schaltet für jedes Steuerelement ChromeState -Eigenschaft, die bestimmt, ob das Steuerelement normal oder minimiert wird.

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";
  }
}

Der zweite Teil des Codebeispiels ist die Webseite, die die Steuerelemente enthält. Beachten Sie, dass die Steuerelemente im deklarierten WebPartZone1 standardmäßige ASP.NET-Serversteuerelemente sind da sind jedoch GenericWebPart Steuerelementen zur Laufzeit und die GenericWebPart Klasse erbt von der WebPart -Klasse, die Steuerelemente werden automatisch als behandelt, WebPart Steuerelementen zur Laufzeit und sind die WebPartCollection Objekt.

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

Laden Sie die Seite in einen Browser, und klicken Sie auf die ChromeState umschalten Schaltfläche, der Code in der partiellen Klasse durchläuft die WebPartCollection -Objekt und auch minimiert die Steuerelemente oder normal zurückgegeben. Oder, wenn Sie wiederholt auf die BulletedList1-Title umschalten klicken, den Titel des obersten Steuerelements in alternative Werte geändert wird.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: