WebPartCollection.Item[] 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
根據集合的位置或唯一識別項，傳回集合的特定成員。
多載
| 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.WebPartDefault Public ReadOnly Property Item(index As Integer) As WebPart參數
屬性值
位在集合中特定索引處的 WebPart。
範例
下列程式代碼範例示範在網頁元件頁面上使用 Item[] 索引器。 此範例有三個部分：
部分類別中頁面的程序代碼。
包含控件的網頁。
範例在瀏覽器中運作方式的描述。
程式代碼範例的第一個部分包含部分類別中頁面的程序代碼。 請注意，方法Button2_Click會建立空WebPartCollection的物件，然後從 WebPartZone1.WebParts 屬性將控件指派給它WebPart。 方法會使用其索引來存取集合中的第一個控件，並切換其 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[]器可讓您依索引存取物件中WebPartCollection的基礎WebPart控件，並變更其屬性值或呼叫方法。
另請參閱
適用於
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.WebPartDefault Public ReadOnly Property Item(id As String) As WebPart參數
屬性值
在集合中，ID 等於 id 值的第一個 WebPart。
備註
索引Item[]器可讓您根據唯一WebPartWebPartCollection標識碼存取 物件中的控件。
注意
Web 元件控制項集會在此屬性上執行不區分大小寫的比對，因此區分大小寫不是唯 id 一值的一部分。
屬性 Item[] 也適用於在某些特殊案例中識別 對象的成員 WebPartCollection 。 在控件的情況下 GenericWebPart ，索引器能夠比對控件所包裝之基礎子控件的 GenericWebPart 標識符。 在控件的情況下ProxyWebPart，索引器會根據參數和 OriginalID 或 GenericWebPartID 屬性值的不區分大小寫比較，比對控件的id標識符。
