WebPartCollection.Item[] Свойство

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls.WebParts

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает определенный элемент коллекции по его позиции или по уникальному идентификатору.

Перегрузки

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

Параметры

index: Int32

Индекс некоторого элемента управления WebPart в коллекции.

Значение свойства

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[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

Параметры

id: String

Уникальный идентификатор для заданного элемента управления WebPart в коллекции.

Значение свойства

WebPart

Первое WebPart в коллекции, у которого идентификатор равен значению id.

Набор элементов управления веб-частей выполняет сопоставление этого свойства без учета регистра, поэтому учет регистра не является частью уникального id значения.

Свойство Item[] также работает для идентификации элементов объекта в некоторых WebPartCollection специализированных случаях. В случае GenericWebPart элементов управления индексатор может сопоставить идентификатор базового дочернего элемента управления, упаковав его в оболочку GenericWebPart . В случае ProxyWebPart элементов управления индексатор сопоставляет идентификатор элемента управления на основе сравнения id параметра и свойства или GenericWebPartID без учета регистраOriginalID.

См. также раздел

элементы управления веб-частей ASP.NET

Применяется к

Поделиться через

WebPartCollection.Item[] Свойство

Определение

Перегрузки

Item[Int32]

Параметры

Значение свойства

Примеры

Комментарии

См. также раздел

Применяется к

Item[String]

Параметры

Значение свойства

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы