WebPartCollection.Item[] Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает определенный элемент коллекции по его позиции или по уникальному идентификатору.
Перегрузки
Item[Int32] |
Возвращает элемент коллекции по его позиции в коллекции. |
Item[String] |
Возвращает элемент коллекции по уникальному строковому идентификатору. |
Item[Int32]
Возвращает элемент коллекции по его позиции в коллекции.
public:
property System::Web::UI::WebControls::WebParts::WebPart ^ default[int] { System::Web::UI::WebControls::WebParts::WebPart ^ get(int index); };
public System.Web.UI.WebControls.WebParts.WebPart this[int index] { get; }
member this.Item(int) : System.Web.UI.WebControls.WebParts.WebPart
Default Public ReadOnly Property Item(index As Integer) As WebPart
Параметры
Значение свойства
WebPart, которое содержится в коллекции по указанному индексу.
Примеры
В следующем примере кода показано использование Item[] индексатора на странице веб-части. В этом примере три части:
Код страницы в разделяемом классе.
Веб-страница, содержащая элементы управления.
Описание работы примера в браузере.
Первая часть примера кода содержит код страницы в разделяемом классе. Обратите внимание, что Button2_Click
метод создает пустой WebPartCollection объект, а затем назначает ему WebPart элементы управления из WebPartZone1.WebParts
свойства. Метод обращается к первому элементу управления в коллекции с помощью индекса и переключает его Title значение свойства.
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>
После загрузки страницы в браузере нажмите кнопку "Переключить маркированный список1" и обратите внимание, что код переключает заголовок элемента управления между двумя доступными вариантами заголовка.
Комментарии
Индексатор Item[] позволяет получить доступ к базовым WebPart элементам управления в WebPartCollection объекте по индексу и изменить их значения свойств или вызвать методы.
См. также раздел
Применяется к
Item[String]
Возвращает элемент коллекции по уникальному строковому идентификатору.
public:
property System::Web::UI::WebControls::WebParts::WebPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::WebPart ^ get(System::String ^ id); };
public System.Web.UI.WebControls.WebParts.WebPart this[string id] { get; }
member this.Item(string) : System.Web.UI.WebControls.WebParts.WebPart
Default Public ReadOnly Property Item(id As String) As WebPart
Параметры
Значение свойства
Первое WebPart в коллекции, у которого идентификатор равен значению id
.
Комментарии
Индексатор Item[] позволяет получить доступ к элементу WebPart управления в WebPartCollection объекте в соответствии с уникальным идентификатором.
Примечание
Набор элементов управления веб-части выполняет сопоставление без учета регистра в этом свойстве, поэтому конфиденциальность регистра не является частью уникального id
значения.
Свойство Item[] также работает для идентификации WebPartCollection членов объекта в некоторых специализированных случаях. В случае элементов управления индексатор может соответствовать идентификатору базового дочернего GenericWebPart элемента управления, завернутого элементом GenericWebPart управления. В случае ProxyWebPart элементов управления индексатор соответствует идентификатору элемента управления на основе сравнения id
параметра без учета регистра и OriginalID значений свойств.GenericWebPartID