WebPartManager Třída

Definice

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

Dědičnost

Object

Control

WebPartManager

Atributy

BindableAttribute

Implementuje

INamingContainer IPersonalizable

Příklady

Následující příklad kódu ukazuje deklarativní i programové použití WebPartManager ovládacího prvku.

Příklad kódu má čtyři části:

• Uživatelský ovládací prvek, který umožňuje měnit režimy zobrazení na stránce webových částí.

• Webová stránka, která obsahuje dva vlastní WebPart ovládací prvky, které lze připojit, a prvek <asp:webpartmanager> .

• Soubor zdrojového kódu, který obsahuje dva vlastní WebPart ovládací prvky a vlastní rozhraní.

• Vysvětlení fungování příkladu v prohlížeči

Uživatelský ovládací prvek má ovládací prvek rozevíracího seznamu, který zobrazuje možné režimy zobrazení na stránce vzhledem k ovládacím prvkům webových částí, které jsou na stránce. Na webové stránce pro tento příklad kódu je tento uživatelský ovládací prvek deklarován těsně pod WebPartManager elementem ve značkách stránky a v horní části webové stránky je Register direktiva pro registraci ovládacího prvku. Podrobnosti o režimech zobrazení a popis zdrojového kódu v tomto ovládacím prvku najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

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

Deklarativní kód webové stránky obsahuje Register direktivy pro uživatelský ovládací prvek i vlastní ovládací prvky. Existuje element <asp:webpartmanager> , element, který <asp:webpartzone> obsahuje vlastní ovládací prvky, a <asp:connectionszone> element. Stránka také obsahuje nějaký vložený kód, který zpracovává události WebPartManager související s připojením ovládacího prvku. Při připojování a odpojování ovládacích prvků můžete vidět účinek tohoto kódu.

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

Třetí částí příkladu je zdrojový kód ovládacích prvků. Všimněte si, že existuje rozhraní s názvem IZipCodea toto rozhraní je implementováno ZipCodeWebPart ve třídě. Tato třída má speciální metodu zpětného volání s názvem ProvideIZipCode , která slouží jako zprostředkovatel. Druhý typ s názvem WeatherWebPartje také implementován se speciální metodou s názvem GetIZipCode, která umožňuje ovládacímu prvku jednat jako příjemce druhého ovládacího prvku.

Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a umístit výsledné sestavení do složky Bin webu nebo globální mezipaměti sestavení . Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Tento příklad kódu předpokládá, že jste zkompilovali zdroj do sestavení a direktiva Register na webové stránce odkazuje na název sestavení. Návod, který ukazuje, jak kompilovat, najdete v tématu Návod: Vývoj a použití vlastního ovládacího prvku webového serveru.

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

Po načtení webové stránky v prohlížeči klikněte na ovládací prvek rozevíracího seznamu Režim zobrazení a výběrem možnosti Připojit přepněte stránku do režimu připojení. Režim připojení používá <asp:connectionszone> element k vytvoření připojení mezi ovládacími prvky. V režimu připojení klikněte na šipku dolů v záhlaví ovládacího prvku PSČ , aby se aktivovala nabídka sloves, a pak klikněte na Připojit. Jakmile se zobrazí uživatelské rozhraní připojení, klikněte na odkaz Vytvořit připojení k příjemci . Zobrazí se buňka s ovládacím prvku rozevíracího seznamu. V rozevíracím seznamu vyberte Ovládací prvek počasí a potom kliknutím na Připojit dokončete propojení těchto dvou ovládacích prvků. Klikněte na Zavřít a potom pomocí rozevíracího seznamu Režim zobrazení vraťte stránku do normálního režimu procházení. Můžete zadat PSČ a ovládací prvek příjemce se aktualizuje hodnotou, kterou zadáte. ZipCode Vzhledem k tomu, že vlastnost byla ve zdrojovém kódu označena atributemPersonalizable, bude tato hodnota vlastnosti zachována napříč relacemi prohlížeče, čímž se uloží hodnota zadaná uživatelem. Sofistikovanější řízení uživatele může převzít informace o PSČ, vyhledat informace o počasí na základě kódu a zobrazit je uživateli.

Poznámky

Ovládací WebPartManager prvek funguje jako centrum nebo řídicí centrum aplikace webových částí. Na každé stránce, která používá ovládací prvky webových částí, musí existovat jedna a pouze jednaWebPartManager instance ovládacího prvku. Stejně jako u většiny aspektů aplikací WebPartManager webových částí funguje ovládací prvek pouze s ověřenými uživateli. Jeho funkce navíc funguje téměř výhradně se serverovými ovládacími prvky, které se nacházejí v zónách webových částí, které dědí z WebZone třídy. Serverové ovládací prvky, které se nacházejí na stránce mimo tyto zóny, můžou mít velmi málo funkcí webových částí nebo interakce s ovládacím WebPartManager prvku.

Jako centrum pro funkce webových částí na stránce WebPartManager provádí ovládací prvek druhy úloh popsané v následující tabulce.

Třída WebPartManager má velkou sadu vlastností. V souladu s WebPartManager rolí sledování jiných ovládacích prvků má řadu vlastností, které odkazují na kolekce ovládacích prvků webových částí nebo jiných speciálních objektů webových částí. Vlastnosti AvailableTransformers, , Connections, Controls, DynamicConnectionsDisplayModesSupportedDisplayModes, WebPartsa Zones jsou kolekce, které WebPartManager ovládací prvek používá ke sledování a dalším úlohám správy.

Jiná skupina vlastností obsahuje přizpůsobitelná upozornění, která platí v určitých scénářích, ke kterým dochází v aplikaci webových částí. Patří mezi ně CloseProviderWarningvlastnosti , DeleteWarning, a .ExportSensitiveDataWarning

Třída WebPartManager přepíše některé ze svých základních zděděných vlastností, které jsou používány mnoha ovládacími prvky webového serveru. Patří mezi ně EnableThemingvlastnosti , SkinIDa Visible .

Nakonec je k dispozici skupina vlastností, které jsou užitečné pro přístup k aktuálnímu stavu aplikace. Vlastnost DisplayMode označuje aktuální režim zobrazení, ve kterém se stránka nachází. Vlastnost EnableClientScript označuje, jestli má ovládací prvek povoleno vykreslovat skript na straně klienta, což je relevantní v situacích, kdy uživatelé můžou mít prohlížeče s různými možnostmi nebo mají skriptování vypnuté. Vlastnost Internals je užitečná pro odkazování na třídu nástroje, která obsahuje volání řady důležitých metod webových částí, které se používají pro případy rozšiřitelnosti. Skrytím volání těchto metod v samostatné třídě ( WebPartManagerInternals třídě) WebPartManager se zjednoduší vlastní rozhraní API třídy. Vlastnost Personalization poskytuje přístup k objektům přizpůsobení, které ukládají nastavení přizpůsobení uživatelů a uchovávají tato data v trvalém úložišti. Vlastnost SelectedWebPart určuje, který WebPart ovládací prvek na stránce je aktuálně vybrán uživatelem nebo aplikací. Vlastnost IPersonalizable.IsDirty označuje, jestli se změnila vlastní data WebPart přizpůsobení ovládacího prvku.

Ovládací WebPartManager prvek obsahuje pět předdefinovaných režimů zobrazení nebo zobrazení webové stránky. Vývojáři mohou tuto funkci rozšířit a vytvořit vlastní režimy zobrazení rozšířením typů, jako WebZone je třída nebo ToolZone třída. Uživatelé mohou přepnout stránku do různých režimů zobrazení za předpokladu, že jsou na stránce k dispozici správné druhy ovládacích prvků, které odpovídají danému režimu zobrazení.

Standardní režimy zobrazení jsou reprezentovány veřejnými WebPartManager poli ve třídě . Následující tabulka shrnuje pole a režimy zobrazení, na které odkazují. Aktuální režim zobrazení stránky, jak je uvedeno výše, je vždy odkazován ve DisplayMode vlastnosti a sada režimů zobrazení, které je možné na konkrétní stránce, vzhledem k druhu zón, které se nacházejí na stránce, je obsažena ve SupportedDisplayModes vlastnosti .

Ovládací WebPartManager prvek obsahuje také řadu událostí, které jsou kritické pro životní cyklus stránek webových částí a ovládacích prvků. Tyto události poskytují přesnou programovou kontrolu nad chováním ovládacích prvků webových částí. Většina metod se týká přímo WebPart ovládacích prvků (nebo jiných serverových nebo uživatelských ovládacích prvků, které jsou umístěny v WebPartZoneBase zónách, aby se mohly chovat jako WebPart ovládací prvky). Několik událostí se ale týká stavu stránky nebo připojení na stránce. Následující tabulka uvádí dostupné události a shrnuje jejich účely.

Ovládací WebPartManager prvek má mnoho metod pro správu stránek webových částí. Velká sada metod, které tu nejsou uvedené, jsou metody, jejichž názvy mají tvar OnEventName. Tyto metody obvykle vyvolávají přidruženou událost a poskytují událost s obslužnou rutinou typu WebPartEventHandler. Většinu těchto metod mohou přepsat vývojáři, kteří dědí z WebPartManager třídy . Vývojáři stránek můžou také poskytovat vlastní obslužné rutiny pro události přidružené k těmto metodám. Například v případě WebPartAdded události může vývojář stránky přidat OnWebPartAdded atribut do elementu <asp:webpartmanager> v kódu webové stránky a pak přiřadit vlastní název metody k atributu, který bude poskytovat vlastní zpracování události. Atribut odpovídá OnWebPartAdded metodě a tento základní vzor zpracování událostí funguje pro většinu událostí webových částí a jejich přidružených metod.

Kromě toho WebPartManager má ovládací prvek metody, které jsou určené pro správu WebPart ovládacích prvků (a serverové nebo uživatelské ovládací prvky používané jako WebPart ovládací prvky). Mezi tyto metody patří , , , CopyWebPartCloseWebPart, CreateWebPart, DeleteWebPart, DisconnectWebPart, BeginWebPartEditing, EndWebPartEditing, ExportWebPart, GetGenericWebPart, ImportWebPart, IsAuthorized, a MoveWebPart. AuthorizeWebPartAddWebPart

Další sada metod se specializuje na připojení. To zahrnuje metody jako ActivateConnections, , BeginWebPartConnecting, CanConnectWebParts, ConnectWebParts, CreateAvailableTransformers, DisconnectWebPart, DisconnectWebParts, EndWebPartConnectingGetConsumerConnectionPointsa GetProviderConnectionPoints.

Některé WebPartManager metody se zaměřují na funkce přizpůsobení. Patří mezi ně CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Savea SaveControlState.

Další informace o dalších WebPartManager metodách, které jsou přístupné prostřednictvím Internals vlastnosti, najdete v dokumentaci ke WebPartManagerInternals třídě .

Poznámky pro dědice

Ovládací WebPartManager prvek je navržen tak, aby byl rozšířen. Vzhledem k tomu, že je to tak centrální pro aplikace webových částí, když chcete rozšířit určitý typ nebo ovládací prvek v sadě ovládacích prvků webových částí, v mnoha případech musíte také rozšířit WebPartManager třídu, protože je pravděpodobné, že má nějakou vlastnost nebo metodu, která je nutná k tomu, aby váš vlastní typ fungoval v kontextu aplikace webových částí. Referenční dokumentace k webovým částem (viz System.Web.UI.WebControls.WebParts) při diskuzi o tom, jak rozšířit typ webových částí, často uvádí, co je potřeba udělat pro rozšíření WebPartManager třídy, nebo ukazuje, jak ji rozšířit v příkladu kódu.

Konstruktory

Pole

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• WebPartManagerInternals
• ASP.NET ovládací prvky webových částí