WebPartManager Klas

Definitie

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

Overname

Object

Control

WebPartManager

Kenmerken

BindableAttribute

Implementeringen

INamingContainer IPersonalizable

Voorbeelden

In het volgende codevoorbeeld ziet u zowel declaratief als programmatisch gebruik van het WebPartManager besturingselement.

Het codevoorbeeld heeft vier delen:

• Een gebruikersbeheer waarmee u weergavemodi op een pagina met webonderdelen kunt wijzigen.

• Een webpagina met twee aangepaste WebPart besturingselementen die kunnen worden verbonden en een <asp:webpartmanager> element.

• Een broncodebestand met twee aangepaste WebPart besturingselementen en een aangepaste interface.

• Een uitleg van hoe het voorbeeld werkt in een browser.

Het gebruikersbesturingselement heeft een besturingselement voor de vervolgkeuzelijst waarin de mogelijke weergavemodi op een pagina worden weergegeven, gezien de besturingselementen voor webonderdelen die aanwezig zijn op de pagina. Op de webpagina voor dit codevoorbeeld wordt dit gebruikersbeheer net onder het element in de WebPartManager markering van de pagina gedeclareerd en er is een Register instructie boven aan de webpagina om het besturingselement te registreren. Zie Overzicht: Weergavemodi wijzigen op een pagina met webonderdelen voor meer informatie over weergavemodi en een beschrijving van de broncode in dit besturingselement.

<%@ 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>

De declaratieve markering voor de webpagina bevat Register instructies voor zowel het gebruikersbesturingselement als de aangepaste besturingselementen. Er is een <asp:webpartmanager> element, een <asp:webpartzone> element dat de aangepaste besturingselementen en een <asp:connectionszone> element bevat. De pagina bevat ook een aantal inlinecode waarmee verbindingsgebeurtenissen voor het WebPartManager besturingselement worden verwerkt. U kunt het effect van deze code zien terwijl u besturingselementen voor verbinding maakt en de verbinding verbreekt.

<%@ 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>

Het derde deel van het voorbeeld is de broncode voor de besturingselementen. Er is een interface met de naam IZipCodeen deze interface wordt geïmplementeerd in de ZipCodeWebPart klasse. Deze klasse heeft een speciale callback-methode die ProvideIZipCode fungeert als provider. Het andere type, genaamd WeatherWebPart, wordt ook geïmplementeerd met een speciale methode genaamd GetIZipCode, waarmee het besturingselement kan fungeren als consument van het andere besturingselement.

Als u het codevoorbeeld wilt uitvoeren, moet u deze broncode compileren. U kunt deze expliciet compileren en de resulterende assembly in de map Bin van uw website of de globale assemblycache plaatsen. U kunt de broncode ook in de map App_Code van uw site plaatsen, waar deze dynamisch wordt gecompileerd tijdens runtime. In dit codevoorbeeld wordt ervan uitgegaan dat u de bron hebt gecompileerd in een assembly en dat de Register instructie op de webpagina verwijst naar de assemblynaam. Zie Walkthrough: Een aangepast webserverbeheer ontwikkelen en gebruiken voor een overzicht van hoe u compileert.

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

Nadat u de webpagina in een browser hebt geladen, klikt u op het besturingselement voor de vervolgkeuzelijst Weergavemodus en selecteert u Verbinding maken om de pagina over te schakelen naar de verbindingsmodus. De verbindingsmodus maakt gebruik van het <asp:connectionszone> element om verbindingen tussen besturingselementen te maken. Klik in de verbindingsmodus op de pijl-omlaag in de titelbalk van het besturingselement Postcode om het menu werkwoorden te activeren en klik vervolgens op Verbinden. Nadat de gebruikersinterface voor de verbinding wordt weergegeven, klikt u op de koppeling Een verbinding met een consument maken . Er wordt een cel weergegeven met een besturingselement voor de vervolgkeuzelijst. Selecteer Weerbesturingselement in de vervolgkeuzelijst en klik vervolgens op Verbinding maken om de verbinding van de twee besturingselementen te voltooien. Klik op Sluiten en gebruik vervolgens de vervolgkeuzelijst Weergavemodus om de pagina terug te zetten naar de normale bladermodus. U kunt een postcode invoeren en het consumentenbeheer wordt bijgewerkt met de waarde die u invoert. Omdat de ZipCode eigenschap is gemarkeerd met het Personalizable kenmerk in de broncode, blijft deze eigenschapswaarde behouden in browsersessies, waardoor de waarde wordt opgeslagen die door een gebruiker is ingevoerd. Een geavanceerder consumentenbeheer kan de postcodegegevens overnemen, weerinformatie opzoeken op basis van de code en deze weergeven aan een gebruiker.

Opmerkingen

Het WebPartManager besturingselement fungeert als het hub- of controlecentrum van een webonderdelentoepassing. Op elke pagina die gebruikmaakt van besturingselementen voor webonderdelen, moet er één en slechts één besturingselementWebPartManager zijn. Net als bij de meeste aspecten van webonderdelentoepassingen werkt het WebPartManager besturingselement alleen met geverifieerde gebruikers. Verder werkt de functionaliteit bijna volledig met serverbesturingselementen die zich in webonderdelenzones bevinden die overnemen van de WebZone klasse. Serverbesturingselementen die zich op een pagina buiten deze zones bevinden, kunnen zeer weinig functionaliteit voor webonderdelen of interactie met het WebPartManager besturingselement hebben.

Als de hub voor webonderdelenfunctionaliteit op een pagina voert het WebPartManager besturingselement de soorten taken uit die in de volgende tabel worden beschreven.

Taakcategorie	Wat het besturingselement doet
Besturingselementen voor webonderdelen bijhouden	Hiermee worden de vele verschillende soorten besturingselementen op een pagina bijgehouden die functies voor webonderdelen bieden, waaronder WebPart besturingselementen, verbindingen, zones en andere.
Besturingselementen voor webonderdelen toevoegen en verwijderen	Biedt de methoden voor het toevoegen, verwijderen en sluiten WebPart van besturingselementen op een pagina.
Verbindingen beheren	Hiermee maakt u verbindingen tussen besturingselementen en bewaakt u de verbindingen, evenals de processen voor het toevoegen en verwijderen ervan.
Besturingselementen en pagina's aanpassen	Hiermee kunnen gebruikers besturingselementen naar verschillende locaties op een pagina verplaatsen en de weergaven starten waarin gebruikers het uiterlijk, de eigenschappen en het gedrag van besturingselementen kunnen bewerken. Onderhoudt gebruikersspecifieke instellingen voor persoonlijke instellingen op elke pagina.
Schakelen tussen verschillende paginaweergaven	Hiermee schakelt u een pagina over tussen verschillende gespecialiseerde weergaven van de pagina, zodat gebruikers bepaalde taken kunnen uitvoeren, zoals het wijzigen van de pagina-indeling of het bewerken van besturingselementen.
Levenscyclusgebeurtenissen voor webonderdelen verhogen	Definieert, verhoogt en stelt ontwikkelaars in staat om levenscyclusgebeurtenissen van besturingselementen voor webonderdelen af te handelen, zoals wanneer besturingselementen worden toegevoegd, verplaatst, verbonden of verwijderd.
Importeren en exporteren van besturingselementen inschakelen	Hiermee exporteert u XML-streams die de status van de eigenschappen van WebPart besturingselementen bevatten en kunnen gebruikers de bestanden voor het gemak importeren bij het personaliseren van complexe besturingselementen op andere pagina's of sites.

De WebPartManager klasse heeft een grote set eigenschappen. Consistent met de rol van het WebPartManager bijhouden van andere besturingselementen, heeft het een aantal eigenschappen die verwijzen naar verzamelingen van besturingselementen voor webonderdelen of andere speciale webonderdelenobjecten. De AvailableTransformerseigenschappen , , Connections, Controls, DisplayModes, DynamicConnections, en ZonesSupportedDisplayModesWebPartseigenschappen zijn alle verzamelingen die door het besturingselement worden gebruikt voor het WebPartManager bijhouden en andere beheertaken.

Een andere groep eigenschappen bevat aanpasbare waarschuwingen die van toepassing zijn in bepaalde scenario's die optreden in een webonderdelentoepassing. Dit zijn onder andere de CloseProviderWarning, de DeleteWarningen de ExportSensitiveDataWarning eigenschappen.

De WebPartManager klasse overschrijft enkele van de overgenomen basiseigenschappen, die door veel webserverbesturingselementen worden gebruikt. Deze omvatten de EnableTheming, SkinIDen Visible eigenschappen.

Ten slotte is er een groep eigenschappen die nuttig is voor toegang tot de huidige status van de toepassing. De DisplayMode eigenschap geeft de huidige weergavemodus aan waarin een pagina zich bevindt. De EnableClientScript eigenschap geeft aan of een besturingselement een script aan de clientzijde mag weergeven. Dit is relevant in situaties waarin gebruikers mogelijk browsers met verschillende mogelijkheden hebben of scripting hebben uitgeschakeld. De Internals eigenschap is handig voor het verwijzen naar een hulpprogrammaklasse die de aanroepen naar een aantal belangrijke webonderdelenmethoden bevat die worden gebruikt voor uitbreidbaarheidscases. Door de aanroepen naar deze methoden in een afzonderlijke klasse (de WebPartManagerInternals klasse) te verbergen, wordt de eigen API van de WebPartManager klasse vereenvoudigd. De Personalization eigenschap biedt toegang tot de persoonlijke instellingen van gebruikers die de persoonlijke instellingen van gebruikers opslaan en die gegevens persistent maken voor permanente opslag. De SelectedWebPart eigenschap geeft aan welk WebPart besturingselement op een pagina momenteel is geselecteerd door de gebruiker of de toepassing. De IPersonalizable.IsDirty eigenschap geeft aan of aangepaste persoonlijke instellingen voor een WebPart besturingselement zijn gewijzigd.

Het WebPartManager besturingselement bevat vijf ingebouwde weergavemodi of weergaven van een webpagina. Ontwikkelaars kunnen deze functie uitbreiden, aangepaste weergavemodi maken door typen zoals de WebZone klasse of de ToolZone klasse uit te breiden. Gebruikers kunnen een pagina overschakelen naar de verschillende weergavemodi, mits het juiste type besturingselementen die overeenkomen met een bepaalde weergavemodus aanwezig zijn op een pagina.

De standaardweergavemodi worden vertegenwoordigd door openbare velden in de WebPartManager klasse. De volgende tabel bevat een overzicht van de velden en de weergavemodi waarnaar ze verwijzen. De huidige weergavemodus van een pagina, zoals hierboven vermeld, wordt altijd verwezen in de DisplayMode eigenschap en de set weergavemodi die mogelijk zijn op een bepaalde pagina, gezien het soort zones dat op de pagina aanwezig is, is opgenomen in de SupportedDisplayModes eigenschap.

Veld	Details van weergavemodus
BrowseDisplayMode	De normale gebruikersweergave van een webpagina; de standaard- en meest voorkomende weergavemodus.
DesignDisplayMode	De weergave waarin gebruikers besturingselementen opnieuw kunnen rangschiknen of verwijderen om de pagina-indeling te wijzigen.
EditDisplayMode	De weergave waarin een gebruikersinterface (UI) bewerken zichtbaar wordt; gebruikers kunnen het uiterlijk, de eigenschappen en het gedrag van de besturingselementen bewerken die zichtbaar zijn in de normale bladermodus.
CatalogDisplayMode	De weergave waarin een catalogusgebruikersinterface zichtbaar wordt; gebruikers kunnen besturingselementen toevoegen aan een pagina vanuit catalogi met beschikbare besturingselementen.
ConnectDisplayMode	De weergave waarin een verbindingsinterface zichtbaar wordt; gebruikers kunnen verbindingen tussen besturingselementen verbinden, beheren of verbreken.

Het WebPartManager besturingselement bevat ook een aantal gebeurtenissen die essentieel zijn in de levenscyclus van pagina's en besturingselementen voor webonderdelen. Deze gebeurtenissen bieden nauwkeurige programmatische controle over het gedrag van besturingselementen voor webonderdelen. De meeste methoden hebben rechtstreeks betrekking op WebPart besturingselementen (of andere server- of gebruikersbesturingselementen die in WebPartZoneBase zones worden geplaatst, zodat ze zich als besturingselementen kunnen gedragen WebPart ). Enkele gebeurtenissen hebben echter betrekking op de status van de pagina of verbindingen op de pagina. De volgende tabel bevat de beschikbare gebeurtenissen en geeft een overzicht van hun doeleinden.

Gebeurtenis	Description
AuthorizeWebPart	Vindt plaats vlak voordat een besturingselement wordt toegevoegd aan een pagina om te controleren of het is geautoriseerd.
ConnectionsActivated	Vindt plaats nadat alle verbindingen op een pagina zijn geactiveerd.
ConnectionsActivating	Vindt plaats vlak voordat alle verbindingen op een pagina worden geactiveerd.
DisplayModeChanged	Vindt plaats nadat de huidige weergavemodus van een pagina is gewijzigd.
DisplayModeChanging	Vindt plaats vlak voordat het proces van het wijzigen van de weergavemodus van een pagina plaatsvindt.
SelectedWebPartChanged	Treedt op nadat de selectie van een besturingselement is geannuleerd.
SelectedWebPartChanging	Vindt plaats vlak vóór het proces van het annuleren van de selectie van een besturingselement.
WebPartAdded	Vindt plaats nadat een besturingselement is toegevoegd aan een zone.
WebPartAdding	Vindt plaats vlak voor het proces van het toevoegen van een besturingselement aan een zone.
WebPartClosed	Treedt op nadat een besturingselement is gesloten (verwijderd van een pagina).
WebPartClosing	Vindt plaats vlak voor het proces van het sluiten van een besturingselement.
WebPartDeleted	Vindt plaats nadat een exemplaar van een dynamisch besturingselement (een besturingselement dat programmatisch is gemaakt of is toegevoegd vanuit een catalogus) definitief is verwijderd.
WebPartDeleting	Vindt plaats vlak voor het proces van het verwijderen van een dynamisch besturingselement.
WebPartMoved	Vindt plaats nadat een besturingselement binnen de zone of naar een andere zone is verplaatst.
WebPartMoving	Vindt plaats vlak voor het proces van het verplaatsen van een besturingselement.
WebPartsConnected	Vindt plaats nadat twee besturingselementen die zijn geselecteerd voor deelname aan een verbinding, de verbinding tot stand hebben gebracht.
WebPartsConnecting	Vindt plaats vlak voor het proces van het verbinden van twee besturingselementen.
WebPartsDisconnected	Treedt op nadat twee verbonden besturingselementen zijn verbroken.
WebPartsDisconnecting	Vindt plaats vlak voordat het proces van het verbreken van twee besturingselementen wordt verbroken.

Het WebPartManager besturingselement heeft talloze methoden voor het beheren van pagina's met webonderdelen. Een grote set methoden, die hier niet worden vermeld, zijn methoden waarvan de namen de vorm hebben van OnEventName. Deze methoden genereren meestal de bijbehorende gebeurtenis en bieden de gebeurtenis een handler van het type WebPartEventHandler. De meeste van deze methoden kunnen worden overschreven door ontwikkelaars die overnemen van de WebPartManager klasse. Paginaontwikkelaars kunnen ook aangepaste handlers bieden voor de gebeurtenissen die aan deze methoden zijn gekoppeld. In het geval van de WebPartAdded gebeurtenis kan een paginaontwikkelaar bijvoorbeeld een OnWebPartAdded kenmerk toevoegen aan het element in de <asp:webpartmanager> opmaak van een webpagina en vervolgens een aangepaste methodenaam toewijzen aan het kenmerk om aangepaste verwerking voor de gebeurtenis te bieden. Het kenmerk komt overeen met de OnWebPartAdded methode en dit basispatroon van gebeurtenisafhandeling werkt voor de meeste webonderdelen-gebeurtenissen en de bijbehorende methoden.

Daarnaast heeft het WebPartManager besturingselement methoden die specifiek zijn voor het beheren WebPart van besturingselementen (en server- of gebruikersbesturingselementen die worden gebruikt als WebPart besturingselementen). Deze methoden omvattenAddWebPart, , AuthorizeWebPart, CloseWebPart, CopyWebPart, CreateWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, , EndWebPartEditing, ImportWebPartIsAuthorizedExportWebPartGetGenericWebPartMoveWebPart, en .

Een andere set methoden is gespecialiseerd voor verbindingen. Dit omvat methoden zoals , , , , ConnectWebParts, CreateAvailableTransformers, , DisconnectWebPart, DisconnectWebParts, , EndWebPartConnectingen GetProviderConnectionPointsGetConsumerConnectionPoints. CanConnectWebPartsBeginWebPartConnectingActivateConnections

Ten slotte richten sommige WebPartManager methoden zich op de functionaliteit van persoonlijke instellingen. Dit zijn onder andere CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, en IPersonalizable.SaveSaveControlState.

Zie de documentatie voor de klasse voor meer informatie over andere WebPartManager methoden die toegankelijk zijn via de InternalsWebPartManagerInternals eigenschap.

Notities voor overnemers

Het WebPartManager besturingselement is ontworpen om te worden uitgebreid. Omdat het zo centraal is bij webonderdelentoepassingen, moet u, wanneer u een bepaald type of besturingselement in de set webonderdelen wilt uitbreiden, in veel gevallen ook de WebPartManager klasse uitbreiden, omdat het waarschijnlijk een eigenschap of methode heeft die nodig is om uw aangepaste type te laten werken in de context van een webonderdelentoepassing. De naslagdocumentatie voor webonderdelen (zie System.Web.UI.WebControls.WebParts), bij het bespreken van hoe u een type webonderdelen uitbreidt, vermeldt regelmatig wat er moet worden gedaan om de WebPartManager klasse uit te breiden of laat zien hoe u deze uitbreidt in een codevoorbeeld.

Zie ook

• WebPartManagerInternals
• ASP.NET besturingselementen voor webonderdelen