WebPartConnection Třída

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Poskytuje objekt, který umožňuje vytvořit připojení dvěma WebPart ovládacími prvky. Tuto třídu nelze 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é propojení mezi dvěma WebPart ovládacími prvky. Příklad ukazuje tři způsoby vytvoření spojení: deklarativním umístěním značek pro připojení do značky webové stránky; prostřednictvím kódu programu 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ý umožňuje uživatelům 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é části na stránce.

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

  • Webová stránka pro hostování všech ovládacích prvků a spuštění příkladu kódu

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

První část tohoto příkladu kódu je uživatelský ovládací prvek, který uživatelům umožňuje mě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ý je blízko horní části hostitelské webové stránky. Podrobnosti o režimech zobrazení a popisu 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é části.

<%@ 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 rozhraní a ovládacích prvků. Zdrojový soubor obsahuje jednoduché rozhraní s názvem IZipCode. Existuje také WebPart třída, 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 označena atributem ConnectionProvider v metadatech. Toto je mechanismus identifikace 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 metadatech.

Abyste mohli spustit příklad kódu, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a výsledné sestavení umístit do složky Bin vašeho webu nebo do globální mezipaměti sestavení. Případně můžete zdrojový kód umístit do složky App_Code webu, kde bude dynamicky kompilován za běhu. Tento příklad kódu používá dynamickou kompilaci. Návod, který ukazuje, jak zkompilovat, 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 uživatelského ovládacího prvku a vlastních WebPart ovládacích prvků. 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 libovolnou předponu 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 poskytuje tři způsoby, jak vytvořit spojení mezi vlastními ovládacími prvky. První metoda je deklarativní. V kódu stránky <StaticConnections> je prvek deklarován a v rámci tohoto <asp:WebPartConnections> prvku, s různými spotřebiteli a podrobnostmi zprostředkovatele připojení zadanými jako atributy. Toto je jeden ze způsobů, jak vytvořit připojení tím, že ho deklaruje přímo na webové stránce, konkrétně v rámci elementu <asp:WebPartManager> . Kvůli tomuto statickému připojení se při prvním načtení stránky vytvoří propojení mezi dvěma vlastními ovládacími prvky.

Druhá metoda vytvoření spojení mezi ovládacími prvky je poskytována <asp:connectionszone> prvkem na stránce. Pokud uživatel přepne stránku do režimu zobrazení připojení za běhu a klikne na příkaz pro připojení na 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í, což je programově. Button1_Click V metodě kód vytvoří ProviderConnectionPoint objekt pro ovládací prvek zprostředkovatele a načte podrobnosti spojovacího bodu voláním GetProviderConnectionPoints metody. Provádí podobnou úlohu pro řízení spotřebitele a volá metodu GetConsumerConnectionPoints . Nakonec vytvoří nový WebPartConnection objekt voláním ConnectWebParts metody na 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ž první připojení existuje, protože je deklarováno v rámci elementu <StaticConnections> . Do ovládacího prvku Zprostředkovatele PSČ zadejte nějaký text a zobrazí se v ovládacím prvku příjemce. Dále odpojte dva ovládací prvky. Pomocí ovládacího prvku Rozevírací seznam v režimu zobrazení změňte stránku tak, aby se připojila k režimu zobrazení. Klikněte na nabídku sloves (reprezentovaná šipkou dolů v záhlaví) u každého WebPart z ovládacích prvků a všimněte si, že každá má možnost Připojení. Jedná se o příkaz pro připojení, 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 pro připojení na jednom z ovládacích prvků a zobrazí se uživatelské rozhraní připojení poskytované ovládacím prvekem ConnectionsZone . Kliknutím na tlačítko Odpojit ukončíte statické připojení mezi ovládacími prvky. Pomocí ovládacího prvku Režim zobrazení vrátíte stránku do režimu procházení. Zkuste znovu zadat nějaký nový text v poskytovateli a všimněte si, že protože ovládací prvky jsou odpojené, text se neaktualizuje v ovládacím prvku příjemce.

V dalším kroku použijte stejnou metodu jako výše a znovu přepněte stránku do režimu zobrazení pro připojení. Klikněte na příkaz připojení 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 připojení vytvoří, poslední řetězec, který jste zadali do ovládacího prvku zprostředkovatele (který se nepodařilo zobrazit, protože ovládací prvky byly odpojeny), se náhle objeví v příjemci, protože připojení bylo znovu vytvořeno. Kliknutím na tlačítko Odpojit ukončíte aktuální připojení, které jste právě vytvořili. Vraťte stránku do režimu procházení. Do zprostředkovatele zadejte nový text, který předvede, že se text neaktualizuje a že ovládací prvky jsou znovu odpojené.

Vraťte stránku pro připojení režimu zobrazení. Místo kliknutí na příkaz připojení klikněte na tlačítko Připojení Ovládací prvky webové části, které znázorňuje třetí metodu vytvoření připojení. Tento přístup spojuje ovládací prvky programově v jednom jednoduchém kroku, aniž by bylo nutné ovládací prvek používat ConnectionsZone . 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, který jste zadali v poskytovateli.

Poznámky

V sadě ovládacích prvků Webové části je připojení propojením nebo přidružením mezi dvěma WebPart ovládacími prvky (nebo jiným serverem nebo uživatelem), které jim umožní sdílet data. Tato schopnost sdílet data umožňuje používat připojené ovládací prvky způsoby, které překračují funkce nabízené 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 informace o místním počasí na základě PSČ, pak propojená funkce těchto dvou ovládacích prvků poskytuje uživatelům větší hodnotu. Chcete-li tento příklad rozšířit, mohou být vytvořeny další ovládací prvky, které také zobrazují informace založené na PSČ, jako je například ovládací prvek s odkazy na místní zprávy, a všechny tyto ovládací prvky, které můžou pracovat s daty PSČ, můžou sdílet data s jedním ovládacím prvku, který poskytuje PSČ. Koncoví uživatelé aplikací Webové části můžou 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í (UI), které ovládací prvek poskytuje, nebo pomocí vlastního uživatelského rozhraní poskytovaného ConnectionsZone vývojářem.

Tento WebPartConnection přehled třídy je obecný příkaz základních podrobností pro 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 Webové části Connections Overview nebo si projděte referenční třídy a příklady kódu uvedené v následující diskuzi. Existuje několik základních aspektů připojení Webové části:

  • Dva WebPart ovládací prvky. Každé Webové části připojení se skládá ze dvou ovládacích prvků. Ovládací prvek se může účastnit více než jednoho připojení současně, ale každé připojení se skládá z přesně 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é ovládací prvky serveru, včetně ovládacích prvků ASP.NET, vlastních ovládacích prvků serveru a uživatelských ovládacích prvků. Ovládací prvky, které nejsou odvozeny od WebPart třídy, pokud jsou umístěny do WebPartZoneBase zóny, jsou automaticky zabaleny GenericWebPart objektem 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 ovládacího prvku serveru se musí nacházet v WebPartZoneBase zóně, aby se mohly účastnit Webové části připojení (a většina dalších funkcí Webové části).

  • Spotřebitelé a poskytovatelé. V každém Webové části připojení existují dva ovládací prvky: poskytovatel dat a příjemce dat. Poskytovatel poskytuje spotřebiteli data prostřednictvím zadané metody zpětného volání, která vrací data ve formě rozhraní. (Příklad vytvoření a zadání 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 poskytovatele. Podrobnosti o tomto spojovacím bodu (jeho popisný název, ID a typ vráceného rozhraní) jsou obsaženy v ProviderConnectionPoint objektu přidruženém k ovládacímu prvku zprostředkovatele. Příjemce obdrží data prostřednictvím zadané metody, která může přijmout instanci rozhraní. Tato metoda se označuje jako spojovací bod příjemce a podrobnosti o spojovacím bodu (název, ID a typ rozhraní) jsou obsaženy v ConsumerConnectionPoint objektu 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 spotřebitel a poskytovatel buď kompatibilní (což znamená, že jejich zadané metody spojovacího bodu můžou fungovat se stejným typem rozhraní), nebo musí existovat WebPartTransformer objekt schopný přeložit typ, který poskytovatel nabízí, do typu, který příjemce rozumí.

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

  • Prostředek pro navázání připojení. Jakmile jsou kompatibilní ovládací prvky příjemce a poskytovatele správně navrženy s metodami spojovacího bodu a umístěny do zóny a WebPartConnection objekt je k dispozici, posledním základním krokem je zahájení připojení. Jedním ze způsobů, jak k tomu může dojít, je vytvoření připojení prostřednictvím uživatelského rozhraní. Pokud umístíte <asp:connectionszone> prvek na stránku a ostatní požadované součásti připojení jsou na místě, uživatel může v době běhu přepnout stránku do režimu zobrazení připojení, klikněte na příkaz připojit příkaz v nabídce příkazů 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 programově provést. V obou případech, ať už prostřednictvím uživatelského rozhraní nebo programově, základní metoda, která inicializuje připojení, je stejná. Aplikace volá metodu ConnectWebParts (nebo ConnectWebParts metodu, pokud používá transformátor) na ovládacím WebPartManager prvku, předává ho poskytovateli, příjemci a jejich příslušné objekty spojovacího bodu a metoda vrátí WebPartConnection 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ěř zcela z vlastností souvisejících s podrobnostmi konkrétního připojení. Několik vlastností se týká řízení spotřebitele 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 k vytvoření připojení.

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

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). IsShared Vlastnost označuje, zda 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, zda je ovládací prvek statický (deklarován v kódu stránky a tak trvalý) nebo dynamický (vytvořený programově, což znamená, že lze odstranit).

Konstruktory

WebPartConnection()

Inicializuje novou instanci WebPartConnection třídy.

Vlastnosti

Consumer

WebPart Získá objekt, který funguje jako řízení 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 pro připojení, které odkazuje na ID objektu sloužícího jako bod připojení příjemce pro toto připojení.
ConsumerID

Získá nebo nastaví hodnotu vlastnosti u 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 je objekt aktuálně zaveden a schopen vyměňovat data mezi jeho poskytovatelem a uživatelskými ovládacími prvky.
IsShared

Získá hodnotu, která označuje, zda WebPartConnection je objekt 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 ve značkách webové stránky nebo vytvořený programově.
Provider

WebPart Získá ovládací prvek, který funguje jako poskytovatel v Webové části připojení.
ProviderConnectionPoint

Získá objekt, který slouží jako spojovací bod pro WebPart ovládací prvek, který funguje jako poskytovatel připojení.
ProviderConnectionPointID

Získá nebo nastaví hodnotu vlastnosti u připojení, které odkazuje na ID objektu sloužícího jako spojovací bod zprostředkovatele pro toto připojení.
ProviderID

Získá nebo nastaví hodnotu vlastnosti 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 Webové části připojení.
Transformers

Získá kolekci WebPartTransformer objektů, které interně používá Webové části ovládací sada.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(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í.

Platí pro

Viz také