WebPartCollection Konstruktory

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci WebPartCollection třídy .

Přetížení

WebPartCollection()	Inicializuje prázdnou novou instanci WebPartCollection třídy .
WebPartCollection(ICollection)	Inicializuje novou instanci objektu WebPartCollection předáním ICollection kolekce ovládacích WebPart prvků.

WebPartCollection()

Inicializuje prázdnou novou instanci WebPartCollection třídy .

public:
 WebPartCollection();

public WebPartCollection ();

Public Sub New ()

Poznámky

Konstruktor WebPartCollection inicializuje prázdnou WebPartCollection instanci třídy . Samotný objekt je jen pro čtení a nemá žádnou metodu pro přidání jednotlivých WebPart ovládacích prvků do něj. Proto budete mít jen málo příležitostí použít tento konstruktor.

Viz také

ASP.NET ovládací prvky webových částí

Platí pro

WebPartCollection(ICollection)

Inicializuje novou instanci objektu WebPartCollection předáním ICollection kolekce ovládacích WebPart prvků.

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)

Parametry

webParts: ICollection

An ICollection z ovládacích WebPart prvků.

Výjimky

ArgumentNullException

webParts je null.

ArgumentException

Objekt v kolekci webParts je null.

-nebo-

Objekt v kolekci webParts není typu WebPart.

Příklady

Následující příklad kódu ukazuje použití konstruktoru WebPartCollection na stránce webových částí. Tento příklad má tři části:

Kód stránky v částečné třídě.
Webová stránka, která obsahuje ovládací prvky.
Popis fungování příkladu v prohlížeči

První část příkladu kódu obsahuje kód pro stránku v částečné třídě. Všimněte si Button1_Click , že metoda vytvoří WebPartCollection objekt, který se skládá ze všech WebPart ovládacích prvků odkazovaných ve WebPartManager.WebParts vlastnosti , která zahrnuje všechny WebPart ovládací prvky na stránce. Metoda iteruje všechny ovládací prvky a přepíná vlastnost každého ovládacího prvku ChromeState , která určuje, zda je tento ovládací prvek normální nebo minimalizovaný.

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

Druhou částí příkladu kódu je webová stránka, která obsahuje ovládací prvky. Všimněte si, že ovládací prvky deklarované v WebPartZone1 jsou standardní ASP.NET serverové ovládací prvky, ale protože jsou zabaleny jako GenericWebPart ovládací prvky za běhu a GenericWebPart třída dědí z WebPart třídy, jsou ovládací prvky automaticky považovány za WebPart ovládací prvky za běhu, a proto jsou zahrnuty do objektu WebPartCollection .

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

Po načtení stránky v prohlížeči klikněte na tlačítko Toggle ChromeState (Přepnout ChromeState ) a všimněte si, že kód v částečné třídě prochází WebPartCollection objektem a střídavě minimalizuje ovládací prvky nebo je vrátí do normálu. Nebo pokud opakovaně kliknete na tlačítko Přepnout název odrážkového seznamu1 , název horního ovládacího prvku se změní na alternativní hodnoty.

Poznámky

Konstruktor WebPartCollection inicializuje instanci WebPartCollection třídy předáním kolekce ovládacích WebPart prvků.

WebPartCollection Přestože je objekt jen pro čtení a neexistuje žádná metoda pro přidání jednotlivých ovládacích prvků do něj, můžete vytvořit vlastní ICollection kolekci ovládacích prvků a předat ji konstruktoruWebPartCollection. To vám umožní vytvářet vlastní kolekce a provádět s nimi hromadné operace. Můžete také přistupovat k podkladovým ovládacím prvkům v kolekci a programově měnit hodnoty jejich vlastností.

Viz také

ASP.NET ovládací prvky webových částí

Platí pro

Sdílet prostřednictvím

WebPartCollection Konstruktory

Definice

Přetížení

WebPartCollection()

Poznámky

Viz také

Platí pro

WebPartCollection(ICollection)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály