WebPartCollection Konstruktor

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menginisialisasi instans baru kelas WebPartCollection.

Overload

WebPartCollection()	Menginisialisasi instans WebPartCollection baru kelas yang kosong.
WebPartCollection(ICollection)	Menginisialisasi instans WebPartCollection baru objek dengan meneruskan ICollection kumpulan WebPart kontrol.

WebPartCollection()

Menginisialisasi instans WebPartCollection baru kelas yang kosong.

public:
 WebPartCollection();

public WebPartCollection ();

Public Sub New ()

Keterangan

WebPartCollection Konstruktor menginisialisasi instans WebPartCollection kosong kelas . Objek itu sendiri bersifat baca-saja dan tidak memiliki metode untuk menambahkan kontrol individual WebPart ke dalamnya; oleh karena itu, Anda akan memiliki sedikit kesempatan untuk menggunakan konstruktor ini.

Lihat juga

ASP.NET Kontrol Bagian Web

Berlaku untuk

WebPartCollection(ICollection)

Menginisialisasi instans WebPartCollection baru objek dengan meneruskan ICollection kumpulan WebPart kontrol.

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)

Parameter

webParts: ICollection

Sebuah ICollection WebPart kontrol.

Pengecualian

ArgumentNullException

webPartsadalah null.

ArgumentException

Objek dalam webParts koleksi adalah null.

-atau-

Objek dalam webParts koleksi bukan tipe WebPart.

Contoh

Contoh kode berikut menunjukkan penggunaan WebPartCollection konstruktor pada halaman Bagian Web. Contoh ini memiliki tiga bagian:

Kode untuk halaman di kelas parsial.
Halaman Web yang berisi kontrol.
Deskripsi tentang cara kerja contoh di browser.

Bagian pertama dari contoh kode berisi kode untuk halaman di kelas parsial. Perhatikan bahwa Button1_Click metode membuat WebPartCollection objek yang terdiri dari semua WebPart kontrol yang dirujuk dalam WebPartManager.WebParts properti , yang mencakup semua WebPart kontrol pada halaman. Metode ini melakukan iterasi melalui semua kontrol, dan mengalihkan properti setiap kontrol ChromeState , yang menentukan apakah kontrol tersebut normal atau diminimalkan.

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

Bagian kedua dari contoh kode adalah halaman Web yang berisi kontrol. Perhatikan bahwa kontrol yang dideklarasikan dalam WebPartZone1 adalah kontrol server ASP.NET standar, tetapi karena dibungkus sebagai GenericWebPart kontrol pada durasi, dan GenericWebPart kelas mewarisi dari WebPart kelas, kontrol secara otomatis diperlakukan sebagai WebPart kontrol pada durasi dan oleh karena itu disertakan dalam WebPartCollection objek .

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

Setelah Anda memuat halaman di browser, klik tombol Alihkan ChromeState , dan perhatikan bahwa kode di kelas parsial berputar melalui WebPartCollection objek dan secara bergantian meminimalkan kontrol atau mengembalikannya ke normal. Atau, jika Anda berulang kali mengklik tombol Alihkan Judul BulletedList1 , judul kontrol paling atas diubah menjadi nilai alternatif.

Keterangan

WebPartCollection Konstruktor menginisialisasi instans WebPartCollection kelas dengan meneruskan kumpulan WebPart kontrol.

WebPartCollection Meskipun objek bersifat baca-saja dan tidak ada metode untuk menambahkan kontrol individual ke dalamnya, Anda dapat membuat koleksi kontrol Anda sendiriICollection, dan meneruskannya ke WebPartCollection konstruktor. Ini memungkinkan Anda membuat koleksi kustom dan melakukan operasi massal pada koleksi tersebut. Anda juga dapat mengakses kontrol yang mendasar dalam koleksi dan mengubah nilai propertinya secara terprogram.

Lihat juga

ASP.NET Kontrol Bagian Web

Berlaku untuk

Bagikan melalui

WebPartCollection Konstruktor

Definisi

Overload

WebPartCollection()

Keterangan

Lihat juga

Berlaku untuk

WebPartCollection(ICollection)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: