WebPartManager Classe

Definição

public ref class WebPartManager : System::Web::UI::Control, System::Web::UI::INamingContainer, System::Web::UI::WebControls::WebParts::IPersonalizable

[System.ComponentModel.Bindable(false)]
public class WebPartManager : System.Web.UI.Control, System.Web.UI.INamingContainer, System.Web.UI.WebControls.WebParts.IPersonalizable

[<System.ComponentModel.Bindable(false)>]
type WebPartManager = class
    inherit Control
    interface INamingContainer
    interface IPersonalizable

Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable

Herança

Object

Control

WebPartManager

Atributos

BindableAttribute

Implementações

INamingContainer IPersonalizable

Exemplos

O exemplo de código seguinte demonstra tanto o uso declarativo como programático do WebPartManager controlo.

O exemplo de código tem quatro partes:

• Um controlo de utilizador que permite alterar modos de visualização numa página de Web Parts.

• Uma página web que contém dois controlos personalizados WebPart que podem ser ligados, e um <asp:webpartmanager> elemento.

• Um ficheiro de código-fonte que contém dois controlos personalizados WebPart e uma interface personalizada.

• Uma explicação de como o exemplo funciona num navegador.

O controlo do utilizador tem um controlo de lista suspensa que mostra os modos de visualização possíveis numa página, tendo em conta os controlos Web Parts presentes na página. Na página Web deste exemplo de código, este controlo do utilizador é declarado logo abaixo do WebPartManager elemento na marcação da página, e existe uma Register diretiva perto do topo da página Web para registar o controlo. Para detalhes sobre modos de visualização e uma descrição do código-fonte neste controlo, consulte Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

A marcação declarativa para a página Web contém Register diretivas tanto para o controlo do utilizador como para os controlos personalizados. Existe um <asp:webpartmanager> elemento, um <asp:webpartzone> elemento para conter os controlos personalizados e um <asp:connectionszone> elemento. A página contém também algum código inline que gere eventos relacionados com a ligação para o WebPartManager controlo; pode ver o efeito deste código ao ligar e desligar os controlos.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  private void UpdateLabelData(int wpCount, int connCount)
  {
    Label1.Text = "WebPart Control Count:  " + wpCount.ToString();
    Label2.Text = "Connections Count: " + connCount.ToString();
  }

  protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

  protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
        OnWebPartsConnected="WebPartManager1_WebPartsConnected" 
        OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ConnectionSampleVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub WebPartManager1_WebPartsConnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub

  Protected Sub WebPartManager1_WebPartsDisconnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub
  
  Private Sub UpdateLabelData(ByVal wpCount As Integer, _
    ByVal connCount As Integer)
    
    Label1.Text = "WebPart Control Count:  " & wpCount.ToString()
    Label2.Text = "Connections Count: " & connCount.ToString()
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

A terceira parte do exemplo é o código-fonte dos controlos. Note que existe uma interface chamada IZipCode, e esta interface é implementada na ZipCodeWebPart classe. Esta classe tem um método especial de callback chamado ProvideIZipCode que serve como fornecedor. O outro tipo, chamado WeatherWebPart, também é implementado com um método especial chamado GetIZipCode, que permite ao controlo atuar como consumidor do outro controlo.

Para que o exemplo de código seja executado, tens de compilar este código-fonte. Pode compilar explicitamente e colocar o assembly resultante na pasta Bin do seu site ou na cache global assembly. Alternativamente, pode colocar o código-fonte na pasta App_Code do seu site, onde será compilado dinamicamente em tempo de execução. Este exemplo de código assume que compilaste o código-fonte numa assembleia, e a Register diretiva na página Web faz referência ao nome da assembleia. Para um guia que demonstra como compilar, consulte Guia: Desenvolvimento e Utilização de um Controlo de Servidor Web Personalizado.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
    DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

Depois de carregar a página Web num navegador, clique no menu suspenso de controlo da lista Modo de Exibição e selecione Ligar para mudar a página para o modo de ligar. O modo Connect usa o <asp:connectionszone> elemento para permitir criar ligações entre controlos. No modo de ligar, clique na seta para baixo na barra de título do controlo do código postal para ativar o menu de verbos e depois clique em Conectar. Depois de aparecer a interface de ligação, clique no link Criar uma ligação para um Consumidor . Aparece uma célula que tem um controlo de lista suspensa. Selecione Controlo do Tempo na lista suspensa e depois clique em Ligar para completar a ligação dos dois controlos. Clique em Fechar e depois use a lista suspensa do Modo de Visualização para devolver a página ao modo normal de navegação. Pode introduzir um código postal, e o controlo de consumo será atualizado com o valor que inserir. Como a ZipCode propriedade foi marcada com o Personalizable atributo no código-fonte, este valor de propriedade persistirá entre as sessões do navegador, poupando assim o valor introduzido pelo utilizador. Um controlo mais sofisticado do consumidor poderia pegar na informação do código postal, consultar informações meteorológicas com base no código e exibi-la ao utilizador.

Observações

O WebPartManager controlo atua como o hub ou centro de controlo de uma aplicação Web Parts. Deve haver uma — e apenas uma —WebPartManager instância de controlo em cada página que utilize controlos Web Parts. Como na maioria dos aspetos das aplicações Web Parts, o controlo WebPartManager funciona apenas com utilizadores autenticados. Além disso, a sua funcionalidade funciona quase inteiramente com controlos de servidor que residem em zonas Web Parts herdadas da WebZone classe. Os controlos de servidor que residem numa página fora destas zonas podem ter muito pouca funcionalidade ou interação do Web Parts com o WebPartManager controlo.

Como hub para a funcionalidade de Web Parts numa página, o WebPartManager controlo executa os tipos de tarefas descritas na tabela seguinte.

Categoria de tarefa	O que o controlo faz
Controlo de Web Parts de Rastreio	Controla os muitos tipos diferentes de controlos numa página que fornecem funcionalidades de Web Parts, incluindo WebPart controlos, ligações, zonas e outros.
Adicionar e remover controlos de Web Parts	Fornece os métodos para adicionar, eliminar e fechar WebPart controlos numa página.
Administração de ligações	Cria ligações entre controlos e monitoriza as ligações, bem como os processos de adição e remoção das mesmas.
Personalização de controlos e páginas	Permite aos utilizadores mover os controlos para diferentes locais numa página e lança as vistas onde os utilizadores podem editar a aparência, propriedades e comportamento dos controlos. Mantém definições de personalização específicas para cada página.
Alternar entre diferentes visualizações de página	Alterna uma página entre diferentes vistas especializadas da página, para que os utilizadores possam realizar certas tarefas, como alterar o layout da página ou os controlos de edição.
Aumentar os eventos do ciclo de vida das Web Parts	Define, eleva e permite aos programadores lidar com eventos do ciclo de vida dos controlos Web Parts, como quando os controlos estão a ser adicionados, movidos, ligados ou eliminados.
Possibilitação da importação e exportação de controlos	Exporta fluxos XML que contêm o estado das propriedades dos WebPart controlos e permite aos utilizadores importar os ficheiros para facilitar a personalização de controlos complexos noutras páginas ou sites.

A WebPartManager classe possui um grande conjunto de propriedades. Em consonância com o WebPartManager papel de rastrear outros controlos, possui várias propriedades que referenciam coleções de controlos Web Parts ou outros objetos especiais de Web Parts. As AvailableTransformerspropriedades , Connections, Controls, DisplayModes, DynamicConnections, SupportedDisplayModes, WebParts, , e Zones são todas coleções usadas pelo WebPartManager controlo para o seu rastreio e outras tarefas de gestão.

Outro grupo de propriedades contém avisos personalizáveis que se aplicam em certos cenários que ocorrem numa aplicação Web Parts. Estas incluem as CloseProviderWarning, as DeleteWarning, e as propriedades ExportSensitiveDataWarning .

A WebPartManager classe sobrepõe algumas das suas propriedades base herdadas, que são usadas por muitos controlos de servidores Web. Estas incluem as EnableTheming, SkinID, e Visible as propriedades.

Por fim, existe um conjunto de propriedades úteis para aceder ao estado atual da aplicação. A DisplayMode propriedade indica o modo de exibição atual em que uma página se encontra. A EnableClientScript propriedade indica se um controlo pode renderizar um script do lado do cliente, o que é relevante em situações em que os utilizadores possam ter navegadores com capacidades diferentes ou ter scripts desligados. A Internals propriedade é útil para referenciar uma classe utilitária que contém as chamadas para vários métodos Web Parts importantes usados em casos de extensibilidade. Ao esconder as chamadas para estes métodos numa classe separada (a WebPartManagerInternals classe), a WebPartManager API própria da classe é simplificada. A Personalization propriedade dá acesso aos objetos de personalização que armazenam as definições de personalização dos utilizadores e mantêm esses dados para armazenamento permanente. A SelectedWebPart propriedade indica qual WebPart o controlo numa página que está atualmente selecionado pelo utilizador ou pela aplicação. A IPersonalizable.IsDirty propriedade indica se os dados de personalização personalizados num WebPart controlo foram alterados.

O WebPartManager controlo contém cinco modos de visualização incorporados, ou vistas de uma página Web. Os programadores podem expandir esta funcionalidade, criando modos de exibição personalizados ao estender tipos como a WebZone classe ou a ToolZone classe. Os utilizadores podem alternar uma página para os vários modos de visualização, desde que o tipo adequado de controlos correspondentes a um determinado modo de visualização esteja presente na página.

Os modos de exibição padrão são representados por campos públicos na WebPartManager classe. A tabela seguinte resume os campos e os modos de visualização a que se referem. O modo de exibição atual de uma página, como referido acima, está sempre referenciado na DisplayMode propriedade, e o conjunto de modos de exibição possível numa página particular, dado o tipo de zonas presentes na página, está contido na SupportedDisplayModes propriedade.

Campo	Detalhes do modo de exibição
BrowseDisplayMode	A visualização normal do utilizador numa página Web; o modo de exibição padrão e mais comum.
DesignDisplayMode	A vista em que os utilizadores podem reorganizar ou eliminar controlos para alterar o layout da página.
EditDisplayMode	A vista em que uma interface de utilizador de edição (UI) se torna visível; Os utilizadores podem editar a aparência, propriedades e comportamento dos controlos visíveis no modo normal de navegação.
CatalogDisplayMode	A vista em que uma interface de catálogo se torna visível; Os utilizadores podem adicionar controlos a uma página a partir de catálogos de controlos disponíveis.
ConnectDisplayMode	A vista em que uma interface de ligação se torna visível; Os utilizadores podem ligar, gerir ou desligar ligações entre controlos.

O WebPartManager controlo contém também vários eventos que são críticos no ciclo de vida das páginas e controlos de Web Parts. Estes eventos fornecem controlo programático preciso sobre o comportamento dos controlos das Web Parts. A maioria dos métodos aplica-se diretamente a WebPart controlos (ou outros controlos de servidor ou utilizador que são colocados em WebPartZoneBase zonas para que possam comportar-se como WebPart controlos). No entanto, alguns eventos dizem respeito ao estado da página ou às ligações nela. A tabela seguinte lista os eventos disponíveis e resume os seus propósitos.

Event	Description
AuthorizeWebPart	Ocorre pouco antes de um controlo ser adicionado a uma página para verificar que está autorizado.
ConnectionsActivated	Ocorre depois de todas as ligações numa página terem sido ativadas.
ConnectionsActivating	Ocorre mesmo antes do processo de ativar todas as ligações numa página.
DisplayModeChanged	Ocorre depois de o modo de exibição atual de uma página ter mudado.
DisplayModeChanging	Ocorre pouco antes do processo de alteração do modo de visualização de uma página.
SelectedWebPartChanged	Ocorre depois de a seleção de um controlo ter sido cancelada.
SelectedWebPartChanging	Ocorre pouco antes do processo de cancelamento da seleção de um controlo.
WebPartAdded	Ocorre depois de um controlo ter sido adicionado a uma zona.
WebPartAdding	Ocorre pouco antes do processo de adicionar um controlo a uma zona.
WebPartClosed	Ocorre depois de um controlo ter sido fechado (removido de uma página).
WebPartClosing	Ocorre pouco antes do processo de encerramento de um controlo.
WebPartDeleted	Ocorre depois de uma instância de um controlo dinâmico (criado programaticamente ou adicionado a partir de um catálogo) ter sido permanentemente eliminada.
WebPartDeleting	Ocorre pouco antes do processo de eliminar um controlo dinâmico.
WebPartMoved	Ocorre depois de um controlo se ter movido dentro da sua zona ou para outra zona.
WebPartMoving	Ocorre pouco antes do processo de mover um controlo.
WebPartsConnected	Ocorre depois de dois controlos selecionados para participar numa ligação terem estabelecido a ligação.
WebPartsConnecting	Ocorre pouco antes do processo de ligação de dois controlos.
WebPartsDisconnected	Ocorre depois de dois controlos ligados terem sido desligados.
WebPartsDisconnecting	Ocorre pouco antes do processo de desligar dois controlos.

O WebPartManager controlo tem vários métodos para gerir páginas de Web Parts. Um grande conjunto dos métodos, não listados aqui, são métodos cujos nomes assumem a forma de OnEventName. Estes métodos normalmente elevam o evento associado e fornecem ao evento um manipulador do tipo WebPartEventHandler. A maioria destes métodos pode ser ultrapassada por programadores que herdam da WebPartManager classe. Além disso, os programadores de páginas podem fornecer handlers personalizados para os eventos associados a estes métodos. Por exemplo, no caso do WebPartAdded evento, um programador de páginas poderia adicionar um OnWebPartAdded atributo ao <asp:webpartmanager> elemento na marcação de uma página Web e depois atribuir um nome de método personalizado ao atributo para fornecer um tratamento personalizado para o evento. O atributo corresponde ao OnWebPartAdded método, e este padrão básico de tratamento de eventos funciona para a maioria dos eventos Web Parts e seus métodos associados.

Além disso, o WebPartManager controlo tem métodos particulares para a tarefa de gerir WebPart controlos (e controlos de servidor ou utilizador usados como WebPart controlos). Estes métodos incluem AddWebPart, AuthorizeWebPart, CloseWebPart, CreateWebPartCopyWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPartImportWebPartGetGenericWebPartIsAuthorizede .MoveWebPart

Outro conjunto de métodos é especializado em ligações. Isto inclui métodos como ActivateConnections, BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPartsDisconnectWebPart, , EndWebPartConnecting, , GetConsumerConnectionPoints, e GetProviderConnectionPoints.

Por fim, alguns WebPartManager métodos focam-se na funcionalidade de personalização. Estes incluem CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save, , e SaveControlState.

Para mais informações sobre outros WebPartManager métodos acessíveis através da Internals propriedade, consulte a documentação da WebPartManagerInternals aula.

Notas para Herdeiros

O WebPartManager controlo foi concebido para ser estendido. Como é tão central nas aplicações Web Parts, quando se pretende estender um tipo ou controlo específico no conjunto de controlo Web Parts, em muitos casos é necessário também estender a WebPartManager classe, pois é provável que ela tenha alguma propriedade ou método necessário para fazer o seu tipo personalizado funcionar no contexto de uma aplicação Web Parts. A documentação de referência Web Parts (ver System.Web.UI.WebControls.WebParts), ao discutir como estender um tipo de Web Parts, menciona frequentemente o que é necessário para estender a WebPartManager classe, ou mostra como estendê-la num exemplo de código.

Ver também

• WebPartManagerInternals
• ASP.NET Controlos de Web Parts