WebPartCollection.Item[] Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Ö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.WebPart

Default Public ReadOnly Property Item(index As Integer) As WebPart

Parametreler

index: Int32

Bir koleksiyondaki belirli WebPart bir denetimin dizini.

Özellik Değeri

WebPart

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.WebPart

Default Public ReadOnly Property Item(id As String) As WebPart

Parametreler

id: String

Koleksiyondaki belirli WebPart bir denetimin benzersiz tanımlayıcısı.

Özellik Değeri

WebPart

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.

Ayrıca bkz.

Web Bölümleri Denetimlerini ASP.NET

Şunlara uygulanır

Aracılığıyla paylaş

WebPartCollection.Item[] Özellik

Tanım

Aşırı Yüklemeler

Item[Int32]

Parametreler

Özellik Değeri

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Item[String]

Parametreler

Özellik Değeri

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar