WebPartCollection Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса WebPartCollection.
Перегрузки
WebPartCollection() |
Инициализирует новый пустой экземпляр класса WebPartCollection. |
WebPartCollection(ICollection) |
Инициализирует новый экземпляр объекта WebPartCollection, передавая коллекцию ICollection элементов управления WebPart. |
WebPartCollection()
Инициализирует новый пустой экземпляр класса WebPartCollection.
public:
WebPartCollection();
public WebPartCollection ();
Public Sub New ()
Комментарии
Конструктор WebPartCollection инициализирует пустой экземпляр WebPartCollection класса. Сам объект доступен только для чтения и не имеет метода добавления в него отдельных WebPart элементов управления. Поэтому вам не придется использовать этот конструктор.
См. также раздел
Применяется к
WebPartCollection(ICollection)
Инициализирует новый экземпляр объекта WebPartCollection, передавая коллекцию ICollection элементов управления WebPart.
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)
Параметры
- webParts
- ICollection
ICollection, состоящая из элементов управления WebPart.
Исключения
webParts
имеет значение null
.
Объект в коллекции webParts
имеет значение null
.
-или-
Тип объекта в коллекции webParts
отличен от типа WebPart.
Примеры
В следующем примере кода показано использование конструктора WebPartCollection на странице веб-части. В этом примере три части:
Код страницы в разделяемом классе.
Веб-страница, содержащая элементы управления.
Описание работы примера в браузере.
Первая часть примера кода содержит код страницы в разделяемом классе. Обратите внимание, что Button1_Click
метод создает объект, состоящий WebPartCollection из всех WebPart элементов управления, на которые ссылается WebPartManager.WebParts свойство, включая все WebPart элементы управления на странице. Метод выполняет итератор по всем элементам управления и переключает свойство каждого элемента управления ChromeState , которое определяет, является ли этот элемент управления нормальным или свернут.
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
Второй частью примера кода является веб-страница, содержащая элементы управления. Обратите внимание, что элементы управления, объявленные как WebPartZone1
стандартные, ASP.NET серверные элементы управления, но поскольку они упаковываются в виде GenericWebPart элементов управления во время выполнения, а GenericWebPart класс наследует от WebPart класса, элементы управления автоматически обрабатываются как WebPart элементы управления во время выполнения и поэтому включаются в 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>
После загрузки страницы в браузере нажмите кнопку Toggle ChromeState и обратите внимание, что код в разделяемом классе циклически проходит через WebPartCollection объект, а также сводит к минимуму элементы управления или возвращает их в нормальное состояние. Или, если вы неоднократно нажимаете кнопку "Переключить Маркированный список1" , заголовок самого верхнего элемента управления изменяется на альтернативные значения.
Комментарии
Конструктор WebPartCollection инициализирует экземпляр WebPartCollection класса, передав коллекцию WebPart элементов управления.
WebPartCollection Хотя объект доступен только для чтения и не существует метода добавления в него отдельных элементов управления, вы можете создать собственную ICollection коллекцию элементов управления и передать ее конструкторуWebPartCollection. Это позволяет создавать пользовательские коллекции и выполнять массовые операции с ними. Вы также можете получить доступ к базовым элементам управления в коллекции и изменить их значения свойств программным способом.