WebPartCollection.Item[] Özellik
Tanım
Ö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.
Koleksiyonun konumuna veya benzersiz tanımlayıcısına göre belirli bir üyesini döndürür.
Aşırı Yüklemeler
| Item[Int32] |
Koleksiyondaki konumuna göre koleksiyonun bir üyesini döndürür. |
| Item[String] |
Benzersiz dize tanımlayıcısını temel alarak koleksiyonun bir üyesini döndürür. |
Item[Int32]
Koleksiyondaki konumuna göre koleksiyonun bir üyesini döndürür.
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 WebPartParametreler
Özellik Değeri
Koleksiyonda belirtilen dizinde A WebPart .
Örnekler
Aşağıdaki kod örneği, web bölümleri sayfasında dizin oluşturucunun Item[] 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önteminin Button2_Click boş WebPartCollection bir nesne oluşturduğunu ve ardından bu nesneye özelliğinden WebPartZone1.WebParts denetimleri atadığını WebPart unutmayın. yöntemi, dizinini kullanarak koleksiyondaki ilk denetime erişir Title ve özellik değerini değiştirir.
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 dikkat edin, ancak çalışma zamanında denetimler olarak GenericWebPart sarmalandığından GenericWebPart ve sınıfı sınıftan WebPart devraldığından, denetimler çalışma zamanında denetim olarak WebPart kabul edilebilir ve bir nesnenin parçası WebPartCollection yapılabilir.
<%@ 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 BulletedList1 Başlığını Değiştir düğmesine tıklayın ve kodun denetimin başlığını kullanılabilir iki başlık seçeneği arasında değiştirdiğini fark edin.
Açıklamalar
Dizin Item[] oluşturucu, bir WebPartCollection nesnedeki temel denetimlere WebPart dizine göre erişmenize ve bunların özellik değerlerini veya çağrı yöntemlerini değiştirmenize olanak tanır.
Ayrıca bkz.
Şunlara uygulanır
Item[String]
Benzersiz dize tanımlayıcısını temel alarak koleksiyonun bir üyesini döndürür.
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 WebPartParametreler
Özellik Değeri
Koleksiyonunda kimliği değerine eşit olan ilk WebPart değerdir id.
Açıklamalar
Dizin oluşturucu, Item[] benzersiz bir WebPart tanımlayıcıya göre bir WebPartCollection nesnedeki denetime erişmenizi sağlar.
Not
Web Bölümleri denetim kümesi bu özellik üzerinde büyük/küçük harfe duyarsız eşleştirme gerçekleştirir, bu nedenle büyük/küçük harf duyarlılığı benzersiz id bir değerin parçası değildir.
Item[] özelliği, bazı özel durumlarda bir WebPartCollection nesnenin üyelerini tanımlamak için de çalışır. Denetimler söz konusu olduğunda GenericWebPart dizin oluşturucu, denetim tarafından sarmalanan temel alınan alt denetimin tanımlayıcısını GenericWebPart eşleştirebiliyor. Denetimler söz konusu olduğunda ProxyWebPart dizin oluşturucu, parametrenin ve veya GenericWebPartID özellik değerlerinin büyük/küçük harfe duyarlı olmayan karşılaştırmasını id temel alarak denetimin tanımlayıcısıyla OriginalID eşleşir.
