WebPartCollection Oluşturucular

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

WebPartCollection sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

WebPartCollection()	sınıfının boş bir yeni örneğini WebPartCollection başlatır.
WebPartCollection(ICollection)	Bir denetim koleksiyonu geçirerek nesnenin WebPartCollection yeni bir ICollection örneğini WebPart başlatır.

WebPartCollection()

sınıfının boş bir yeni örneğini WebPartCollection başlatır.

public:
 WebPartCollection();

public WebPartCollection ();

Public Sub New ()

Açıklamalar

Oluşturucu, WebPartCollection sınıfın boş bir örneğini WebPartCollection başlatır. Nesnenin kendisi salt okunurdur ve tek tek WebPart denetimleri eklemek için bir yöntemi yoktur; bu nedenle, bu oluşturucuyu kullanmak için çok az zaman ayırabilirsiniz.

Ayrıca bkz.

Web Bölümleri Denetimlerini ASP.NET

Şunlara uygulanır

WebPartCollection(ICollection)

Bir denetim koleksiyonu geçirerek nesnenin WebPartCollection yeni bir ICollection örneğini WebPart başlatır.

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)

Parametreler

webParts: ICollection

Denetimlerden ICollection biri WebPart .

Özel durumlar

ArgumentNullException

webParts, null değeridir.

ArgumentException

Koleksiyondaki webParts bir nesne şeklindedir null.

-veya-

Koleksiyondaki webParts bir nesne türünde WebPartdeğil.

Örnekler

Aşağıdaki kod örneği, bir Web Bölümleri sayfasında oluşturucunun WebPartCollection kullanımını gösterir. Bu örnekte üç bölüm vardır:

Kısmi sınıftaki sayfanın kodu.
Denetimleri içeren Web sayfası.
Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Kod örneğinin ilk bölümü, kısmi sınıftaki sayfanın kodunu içerir. yöntemininButton1_Click, sayfadaki tüm denetimleri içeren özelliğinde WebPartManager.WebParts başvurulan tüm WebPart WebPart denetimlerden oluşan bir WebPartCollection nesne oluşturduğuna dikkat edin. yöntemi tüm denetimlerde yinelenir ve her denetimin ChromeState özelliğini değiştirir ve bu da denetimin normal mi yoksa simge durumuna küçültülmüş mü olduğunu belirler.

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

Kod örneğinin ikinci bölümü, denetimleri içeren Web sayfasıdır. içinde WebPartZone1 bildirilen denetimlerin standart ASP.NET sunucu denetimleri olduğuna, ancak çalışma zamanında denetim olarak GenericWebPart sarmalandığından GenericWebPart ve sınıfı sınıftan WebPart devraldığından, denetimler otomatik olarak çalışma zamanında denetim olarak WebPart kabul edilir ve bu nedenle nesneye WebPartCollection eklenir.

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

Sayfayı bir tarayıcıda yükledikten sonra ChromeState'i Aç/Kapat düğmesine tıklayın ve kısmi sınıftaki kodun nesnede WebPartCollection döngüye geçtiğine ve alternatif olarak denetimleri simge durumuna küçülttdüğüne veya normale döndürdüğüne dikkat edin. Alternatif olarak, BulletedList1 Başlığını Değiştir düğmesine art arda tıklarsanız, en üstteki denetimin başlığı alternatif değerlere dönüştürülür.

Açıklamalar

Oluşturucu, WebPartCollection bir denetim koleksiyonu geçirerek sınıfının bir örneğini WebPartCollection WebPart başlatır.

Bir WebPartCollection nesne salt okunur olsa ve tek tek denetimleri ekleme yöntemi olmasa da, kendi ICollection denetim koleksiyonunuzu oluşturabilir ve bunu oluşturucuya WebPartCollection geçirebilirsiniz. Bu sayede özel koleksiyonlar oluşturabilir ve bunlar üzerinde toplu işlemler gerçekleştirebilirsiniz. Ayrıca koleksiyondaki temel denetimlere erişebilir ve özellik değerlerini program aracılığıyla değiştirebilirsiniz.

Ayrıca bkz.

Web Bölümleri Denetimlerini ASP.NET

Şunlara uygulanır

Aracılığıyla paylaş

WebPartCollection Oluşturucular

Tanım

Aşırı Yüklemeler

WebPartCollection()

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

WebPartCollection(ICollection)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar