WebPartConnection Třída

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Poskytuje objekt, který umožňuje dvěma WebPart ovládacím prvkům vytvořit připojení. Tato třída se nemůže dědit.

public ref class WebPartConnection sealed

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class WebPartConnection

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type WebPartConnection = class

Public NotInheritable Class WebPartConnection

Dědičnost

Object

WebPartConnection

Atributy

TypeConverterAttribute

Příklady

Následující příklad kódu ukazuje, jak vytvořit jednoduché připojení mezi dvěma WebPart ovládacími prvky. Příklad ukazuje tři způsoby vytvoření připojení: deklarativně, umístěním značek pro připojení do značky webové stránky; programově vytvořením připojení v kódu; a prostřednictvím uživatelského rozhraní umístěním ConnectionsZone ovládacího prvku na stránku, který uživatelům umožňuje navázat připojení.

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

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

• Zdrojový kód pro rozhraní a dva WebPart ovládací prvky, které fungují jako zprostředkovatel a příjemce připojení.

• Webová stránka pro hostování všech ovládacích prvků a spuštění ukázkového kódu.

• Vysvětlení, jak spustit ukázkovou stránku

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje uživatelům změnit režimy zobrazení na webové stránce. Uložte následující zdrojový kód do souboru .ascx a dejte mu název souboru, který je přiřazen Src atributu Register direktivy pro tento uživatelský ovládací prvek, který se nachází v horní části hostující webové stránky. 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>

Druhá část příkladu kódu je zdrojový kód pro rozhraní a ovládací prvky. Zdrojový soubor obsahuje jednoduché rozhraní s názvem IZipCode. K dispozici je také WebPart třída s názvem ZipCodeWebPart , která implementuje rozhraní a funguje jako ovládací prvek zprostředkovatele. Jeho ProvideIZipCode metoda je metoda zpětného volání, která implementuje jediný člen rozhraní. Metoda jednoduše vrátí instanci rozhraní. Všimněte si, že metoda je v metadatech označená atributem ConnectionProvider . Toto je mechanismus pro identifikaci metody jako metody zpětného volání pro spojovací bod poskytovatele. Druhá WebPart třída má název WeatherWebParta funguje jako příjemce připojení. Tato třída má metodu s názvem GetZipCode , která získá instanci IZipCode rozhraní z ovládacího prvku zprostředkovatele. Všimněte si, že tato metoda je označena jako metoda spojovacího bodu příjemce s atributem ConnectionConsumer v jeho metadatech.

Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a vložit výsledné sestavení do složky Bin webu nebo globální mezipaměti sestavení (GPA). 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 používá dynamickou kompilaci. 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 Provider", "ZipCodeProvider")]
    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 Consumer", "ZipCodeConsumer")]
    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 Provider", "ZipCodeProvider")> _
    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 Consumer", "ZipCodeConsumer")> _
    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

Třetí částí příkladu kódu je webová stránka. V horní části jsou direktivy Register pro uživatelský ovládací prvek a vlastní WebPart ovládací prvky. Vzhledem k tomu, že příklad předpokládá dynamickou kompilaci ovládacích prvků, zdrojový kód ovládacích prvků by měl být v podsložce App_Code; značka Register na stránce odkazuje pouze na předponu libovolné značky a obor názvů ovládacích prvků. Vlastní WebPart ovládací prvky (zprostředkovatel a příjemce) jsou deklarovány v elementu webové stránky <asp:webpartzone> uvnitř elementu <zonetemplate> .

Stránka nabízí tři způsoby, jak vytvořit spojení mezi vlastními ovládacími prvky. První metoda je deklarativní. Ve značkách pro stránku <StaticConnections> je deklarován prvek a v rámci tohoto elementu <asp:WebPartConnections> je prvek s různými podrobnostmi příjemce a zprostředkovatele připojení zadanými jako atributy. Toto je jeden ze způsobů, jak vytvořit připojení deklarováním přímo na webové stránce, konkrétně v rámci elementu <asp:WebPartManager> . Kvůli tomuto statickému připojení se spojení mezi těmito dvěma vlastními ovládacími prvky vytvoří okamžitě při prvním načtení stránky.

Druhou metodu vytvoření spojení mezi ovládacími prvky poskytuje <asp:connectionszone> prvek na stránce. Pokud uživatel přepne stránku do režimu zobrazení připojení za běhu a klikne na příkaz připojit v jednom z vlastních ovládacích prvků, <asp:connectionszone> prvek automaticky vykreslí uživatelské rozhraní pro vytvoření připojení.

Stránka také ukazuje třetí způsob vytvoření připojení, kterým je programově. Button1_Click V metodě kód vytvoří ProviderConnectionPoint objekt pro ovládací prvek zprostředkovatele a načte podrobnosti o jeho spojovacím bodu voláním GetProviderConnectionPoints metody . Provádí podobnou úlohu pro ovládací prvek příjemce a volá metodu GetConsumerConnectionPoints . Nakonec vytvoří nový WebPartConnection objekt voláním ConnectWebParts metody v ovládacím WebPartManager prvku .

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuCS"
    Src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

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

  protected void Button1_Click(object sender, EventArgs e)
  {
    ProviderConnectionPoint provPoint = 
      mgr.GetProviderConnectionPoints(zip1)["ZipCodeProvider"];
    ConsumerConnectionPoint connPoint = 
      mgr.GetConsumerConnectionPoints(weather1)["ZipCodeConsumer"];
    WebPartConnection conn1 = mgr.ConnectWebParts(zip1, provPoint,
      weather1, connPoint);
  }

  protected void mgr_DisplayModeChanged(object sender, 
    WebPartDisplayModeEventArgs e)
  {
    if (mgr.DisplayMode == WebPartManager.ConnectDisplayMode)
      Button1.Visible = true;
    else
      Button1.Visible = false;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" 
    OnDisplayModeChanged="mgr_DisplayModeChanged">
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1"
            ProviderConnectionPointID="ZipCodeProvider"
            ProviderID="zip1" />
        </StaticConnections>
      </asp:WebPartManager>
      <uc1:DisplayModeMenuCS ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" 
    Visible="false" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuVB"
    Src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

<!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 Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Dim provPoint As ProviderConnectionPoint = _
      mgr.GetProviderConnectionPoints(zip1)("ZipCodeProvider")
    Dim connPoint As ConsumerConnectionPoint = _
      mgr.GetConsumerConnectionPoints(weather1)("ZipCodeConsumer")
    mgr.ConnectWebParts(zip1, provPoint, weather1, connPoint)

  End Sub

  Protected Sub mgr_DisplayModeChanged (ByVal sender as Object, _
    ByVal e as WebPartDisplayModeEventArgs)

    If mgr.DisplayMode Is WebPartManager.ConnectDisplayMode Then
    Button1.Visible = True
    Else
    Button1.Visible = False
    End If

  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" 
    OnDisplayModeChanged="mgr_DisplayModeChanged">
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1"
            ProviderConnectionPointID="ZipCodeProvider"
            ProviderID="zip1" />
        </StaticConnections>
      </asp:WebPartManager>
      <uc1:DisplayModeMenuVB ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" 
    Visible="false" />
    </div>
    </form>
</body>
</html>

Po načtení webové stránky v prohlížeči již existuje první připojení, protože je deklarováno v elementu <StaticConnections> . Zadejte nějaký text do ovládacího prvku zprostředkovatele PSČ a ten se zobrazí v ovládacím prvku příjemce. Potom tyto dva ovládací prvky odpojte. Pomocí ovládacího prvku rozevíracího seznamu Režim zobrazení změňte stránku tak, aby se připojil režim zobrazení. Klikněte na nabídku sloves (představovanou šipkou dolů v záhlaví) pro každý z ovládacích WebPart prvků a všimněte si, že každý ovládací prvek má možnost Připojit . Jedná se o příkaz connect, který se zobrazí v nabídce sloves pouze v případě, že je stránka v režimu připojení. Klikněte na příkaz connect na jednom z ovládacích prvků a zobrazí se uživatelské rozhraní připojení poskytované ovládacím ConnectionsZone prvek. Kliknutím na tlačítko Odpojit ukončete statické připojení mezi ovládacími prvky. Pomocí ovládacího prvku Režim zobrazení vraťte stránku do režimu procházení. Zkuste ve zprostředkovateli znovu zadat nový text a všimněte si, že protože ovládací prvky jsou odpojené, text se v ovládacím prvku příjemce neaktualizuje.

Pak použijte stejnou metodu jako výše a znovu přepněte stránku do režimu zobrazení připojení. Klikněte na příkaz connect na jednom z ovládacích prvků. Klikněte na odkaz Vytvořit připojení a pomocí uživatelského rozhraní, které ConnectionsZone ovládací prvek poskytuje, vytvořte propojení mezi ovládacími prvky. Toto je druhá metoda pro vytvoření připojení. Všimněte si, že jakmile se vytvoří připojení, poslední řetězec, který jste zadali v ovládacím prvku zprostředkovatele (který se nepodařilo zobrazit, protože ovládací prvky byly odpojeny), se náhle zobrazí ve spotřebiteli, protože připojení bylo vytvořeno znovu. Kliknutím na tlačítko Odpojit ukončete aktuální připojení, které jste právě vytvořili. Vraťte stránku do režimu procházení. Zadejte do zprostředkovatele nějaký nový text, abyste si ukázali, že se text neaktualizuje a že ovládací prvky jsou znovu odpojeny.

Vraťte stránku pro připojení režimu zobrazení. Místo kliknutí na příkaz connect klikněte na tlačítko Připojit ovládací prvky webových částí , které znázorňuje třetí způsob vytvoření připojení. Tento přístup propojí ovládací prvky programově v jednom jednoduchém ConnectionsZone kroku, aniž byste je museli používat. Všimněte si, že při vytváření připojení se v ovládacím prvku příjemce náhle zobrazí poslední řetězec zadaný ve zprostředkovateli.

Poznámky

V sadě ovládacích prvků webové části je propojení nebo přidružení mezi dvěma WebPart ovládacími prvky (nebo jiným serverem nebo uživatelem), které jim umožňují sdílet data. Tato schopnost sdílet data umožňuje použití připojených ovládacích prvků způsoby, které překračují funkčnost nabízenou izolovanými ovládacími prvky. Pokud například jeden ovládací prvek poskytuje data PSČ a jiný ovládací prvek může tato data číst a poskytovat místní informace o počasí na základě PSČ, pak propojená funkce těchto dvou ovládacích prvků poskytuje uživatelům větší hodnotu. Pro rozšíření tohoto příkladu by mohly být vytvořeny další ovládací prvky, které také zobrazují informace na základě PSČ, například ovládací prvek s odkazy na místní zprávy, a všechny tyto ovládací prvky, které mohou pracovat s daty PSČ, mohou sdílet data s jedním ovládacím prvku, který poskytuje PSČ. Koncoví uživatelé aplikací webových částí mohou vytvářet a spravovat připojení mezi všemi těmito kompatibilními ovládacími prvky přímo z webového prohlížeče, pomocí standardního uživatelského rozhraní připojení poskytovaného ConnectionsZone ovládacím prvek nebo pomocí vlastního uživatelského rozhraní poskytnutého vývojářem.

Tento WebPartConnection přehled třídy je obecným prohlášením základních podrobností o vytvoření připojení. Další informace o konkrétních komponentách a požadavcích souvisejících s vytvářením připojení najdete v tématu Přehled připojení webových částí nebo v referenčních třídách a příkladech kódu uvedených v následující diskuzi. Existuje několik základních aspektů připojení webových částí:

• Dva WebPart ovládací prvky. Každé připojení webových částí se skládá ze dvou ovládacích prvků. Je možné, že se ovládací prvek účastní více než jednoho připojení současně, ale každé připojení se skládá přesně ze dvou ovládacích prvků. Ovládací prvky mohou být odvozeny přímo ze WebPart základní třídy nebo mohou být jiné serverové ovládací prvky, včetně ovládacích prvků ASP.NET, vlastních serverových ovládacích prvků a uživatelských ovládacích prvků. Ovládací prvky, které nejsou odvozeny od WebPart třídy, jsou-li umístěny v WebPartZoneBase zóně, jsou automaticky zabaleny s objektem GenericWebPart za běhu, což jim umožňuje dědit z WebPart třídy a fungovat jako ovládací prvky za běhu WebPart .

• Ovládací prvky umístěné v WebPartZoneBase zónách. Ovládací WebPart prvky i jakýkoli jiný typ serverového ovládacího prvku se musí nacházet v WebPartZoneBase zóně, aby se mohly účastnit připojení webových částí (a většiny dalších funkcí webových částí).

• Spotřebitelé a poskytovatelé. V každém připojení webových částí jsou dva ovládací prvky: zprostředkovatel dat a příjemce dat. Zprostředkovatel poskytuje data příjemci prostřednictvím zadané metody zpětného volání, která vrací data ve formě rozhraní. (Příklad vytvoření a určení metody zpětného volání najdete v části Příklad tohoto tématu.) Tato metoda zpětného volání se označuje jako spojovací bod zprostředkovatele. Podrobnosti o tomto spojovacím bodu (jeho "popisný" název, ID a typ vráceného rozhraní) jsou obsaženy v objektu ProviderConnectionPoint přidruženém k ovládacímu prvku zprostředkovatele. Příjemce přijímá data prostřednictvím zadané metody, která může přijmout instanci rozhraní. Tato metoda se označuje jako bod připojení příjemce a podrobnosti o spojovacím bodu (název, ID a typ rozhraní) jsou obsaženy v objektu ConsumerConnectionPoint přidruženém k ovládacímu prvku příjemce.

• Kompatibilní ovládací prvky nebo platný transformátor. Aby připojení fungovalo, musí být buď příjemce a poskytovatel kompatibilní (to znamená, že jejich zadané metody spojovacího bodu mohou pracovat se stejným typem rozhraní), nebo musí existovat WebPartTransformer objekt schopný převést typ nabízený poskytovatelem na typ, kterému spotřebitel rozumí.

• Objekt WebPartConnection . Aby připojení existovalo, musí existovat instance WebPartConnection třídy, která obsahuje odkazy na ovládací prvky zprostředkovatele a příjemce spolu s podrobnostmi o jejich spojovacích bodech. Pokud zprostředkovatel a příjemce nejsou kompatibilní a místo toho k připojení používají WebPartTransformer objekt, připojení odkazuje na transformátor.

• Prostředek pro navázání spojení. Po správném návrhu kompatibilních ovládacích prvků příjemce a zprostředkovatele pomocí metod spojovacího bodu a umístění do zóny a zpřístupnění objektu WebPartConnection je posledním základním krokem, který je potřeba zahájit připojení. Jedním ze způsobů, jak k tomu může dojít, je, že uživatelé vytvoří připojení prostřednictvím uživatelského rozhraní. Pokud umístíte prvek <asp:connectionszone> na stránku a ostatní požadované komponenty pro připojení jsou na místě, může uživatel za běhu přepnout stránku do režimu zobrazení připojení, kliknout na příkaz připojit v nabídce sloves poskytovatele nebo příjemce a zobrazí se uživatelské rozhraní připojení (na ConnectionsZone základě ovládacího prvku). Prostřednictvím tohoto uživatelského rozhraní může uživatel zahájit připojení. Dalším způsobem, jak zahájit připojení, je provést to programově. V obou případech, ať už prostřednictvím uživatelského rozhraní nebo programově, je základní metoda, která inicializuje připojení, stejná. Aplikace volá metodu ConnectWebParts (nebo metodu ConnectWebParts , pokud používá transformátor) na WebPartManager ovládacím prvku, předává jí zprostředkovatele, příjemce a jejich příslušné objekty spojovacího WebPartConnection bodu a metoda vrátí objekt.

Třída WebPartConnection definuje objekt, který zapouzdřuje základní podrobnosti spojení mezi dvěma WebPart ovládacími prvky. Třída se skládá téměř výhradně z vlastností souvisejících s podrobnostmi konkrétního připojení. Několik vlastností se týká řízení příjemce v připojení. Vlastnost Consumer odkazuje na samotný ovládací prvek příjemce a ConsumerID vlastnost odkazuje na ID příjemce. Na ConsumerConnectionPoint objekt, který obsahuje podrobnosti o spojovacím bodu příjemce, odkazuje vlastnost příjemce ConsumerConnectionPoint . Vlastnost ConsumerConnectionPointID odkazuje na ID objektu ConsumerConnectionPoint . Všechny tyto vlastnosti připojení související s příjemcem musí mít přiřazenou hodnotu, aby se vytvořilo připojení.

Třída WebPartConnection má také několik vlastností, které se vztahují k ovládacímu prvku zprostředkovatele v připojení a odpovídají vlastnostem příjemce. Vlastnost Provider odkazuje na samotný ovládací prvek zprostředkovatele, zatímco ProviderID vlastnost odkazuje na jeho ID. Vlastnost ProviderConnectionPoint odkazuje na ProviderConnectionPoint objekt a ProviderConnectionPointID vlastnost odkazuje na ID spojovacího bodu zprostředkovatele.

Několik vlastností se týká stavu připojení. Vlastnost IsActive označuje, jestli je připojení aktivní (aktuálně vyměňuje data) nebo neaktivní (stále připojené, ale aktivně nesdílí data). Vlastnost IsShared označuje, jestli je připojení sdílené (dostupné všem uživatelům stránky) nebo připojení specifické pro uživatele a IsStatic vlastnost označuje, jestli je ovládací prvek statický (deklarovaný ve značkách stránky a tedy trvalý) nebo dynamický (vytvořený programově, což znamená, že ho lze odstranit).

Konstruktory

WebPartConnection()

Inicializuje novou instanci WebPartConnection třídy .

Vlastnosti

Consumer	WebPart Získá objekt, který funguje jako ovládací prvek příjemce v připojení.
ConsumerConnectionPoint	Získá objekt, který slouží jako spojovací bod pro ovládací prvek, který funguje jako příjemce v připojení.
ConsumerConnectionPointID	Získá nebo nastaví hodnotu vlastnosti na připojení, které odkazuje na ID objektu, který slouží jako bod připojení příjemce pro toto připojení.
ConsumerID	Získá nebo nastaví hodnotu vlastnosti na připojení, které odkazuje na ID WebPart ovládacího prvku, který funguje jako příjemce pro toto připojení.
ID	Získá nebo nastaví ID objektu WebPartConnection .
IsActive	Získá hodnotu, která označuje, zda WebPartConnection objekt je aktuálně vytvořen a může vyměňovat data mezi jeho zprostředkovatel a příjemce ovládací prvky.
IsShared	Získá hodnotu, která označuje, zda WebPartConnection objekt je viditelný pro všechny uživatele nebo pouze pro aktuálního uživatele.
IsStatic	Získá hodnotu, která označuje, zda WebPartConnection je objekt deklarován v kódu webové stránky nebo vytvořen programově.
Provider	Získá ovládací prvek WebPart , který funguje jako zprostředkovatel v připojení webových částí.
ProviderConnectionPoint	Získá objekt, který slouží jako spojovací bod pro WebPart ovládací prvek, který funguje jako zprostředkovatel pro připojení.
ProviderConnectionPointID	Získá nebo nastaví hodnotu vlastnosti na připojení, která odkazuje na ID objektu, který slouží jako spojovací bod zprostředkovatele pro toto připojení.
ProviderID	Získá nebo nastaví hodnotu vlastnosti na připojení, které odkazuje na ID WebPart ovládacího prvku, který funguje jako zprostředkovatel pro toto připojení.
Transformer	WebPartTransformer Získá objekt, který se používá k transformaci dat mezi dvěma jinak nekompatibilními spojovacími body v připojení webových částí.
Transformers	Získá kolekci WebPartTransformer objektů používaných interně sadou webových částí ovládacího prvku.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Přepíše zděděnou ToString() metodu a vrátí krátký název typu pro objekt připojení.

Viz také

• ConnectionPoint
• ProviderConnectionPoint
• ConsumerConnectionPoint
• WebPartManager
• ConnectionsZone
• WebPartTransformer
• ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)
• Přehled připojení webových částí
• ASP.NET ovládací prvky webových částí