ConsumerConnectionPoint Třída

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Definuje objekt bodu připojení, který umožňuje serverovému ovládacímu prvku fungujícímu jako příjemce vytvořit připojení se zprostředkovatelem.

public ref class ConsumerConnectionPoint : System::Web::UI::WebControls::WebParts::ConnectionPoint

public class ConsumerConnectionPoint : System.Web.UI.WebControls.WebParts.ConnectionPoint

type ConsumerConnectionPoint = class
    inherit ConnectionPoint

Public Class ConsumerConnectionPoint
Inherits ConnectionPoint

Dědičnost

Object

ConnectionPoint

ConsumerConnectionPoint

Příklady

Následující příklad kódu ukazuje jednoduché způsoby, jak vytvořit připojení deklarativně, programově nebo prostřednictvím uživatelského rozhraní, v každém případě s využitím bodu připojení příjemce.

Příklad 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 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í 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ý umožňuje uživatelům 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ý 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>

Druhou čá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 s názvem ZipCodeWebPart , která implementuje rozhraní a funguje jako ovládací prvek zprostředkovatele. 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. Toto je mechanismus pro identifikaci metody spojovacího bodu v ovládacím prvku příjemce.

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 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 Register direktivy pro registraci vlastních ovládacích prvků, které tvoří připojení, a uživatelský ovládací prvek, který umožňuje uživatelům měnit režimy zobrazení na stránce. Samotné připojení se vytvoří deklarativně v rámci elementu <staticconnections> na stránce. To ukazuje jeden ze způsobů, jak vytvořit připojení – všimněte si atributu ConsumerConnectionPointID v elementu <asp:webpartconnection> . Připojení můžete vytvořit také prostřednictvím kódu programu. kód pro provedení je v Button1_Click metodě. V tomto případě ConsumerConnectionPoint se vytvoří objekt a pak se předá metodě, která vytvoří skutečné připojení. Bez ohledu na to, jestli se připojení vytváří deklarativně nebo programově, musí být spojovací body vždy zadány pro poskytovatele i příjemce. Metoda Button2_Click přistupuje k objektům ConnectionPoint pro zprostředkovatele i příjemce a zapisuje některé hodnoty jejich vlastností do popisku na stránce.

<%@ 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"];
      
    if(mgr.CanConnectWebParts(zip1, provPoint, weather1, connPoint))
      mgr.ConnectWebParts(zip1, provPoint, weather1, connPoint);
  
  }  
  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartConnection conn = mgr.Connections[0];
    
    lblConn.Text = "<h2>Connection Point Details</h2>" + 
       "<h3>Provider Connection Point</h3>" + 
       "  Display name: " + conn.ProviderConnectionPoint.DisplayName + 
       "<br />" + 
       "  ID: " + conn.ProviderConnectionPoint.ID + 
       "<br />" + 
       "  Interface type: " + 
        conn.ProviderConnectionPoint.InterfaceType.ToString() + 
       "<br />" + 
       "  Control type: " + conn.ProviderConnectionPoint.ControlType.ToString() + 
       "<br />" + 
       "  Allows multiple connections: " + 
          conn.ProviderConnectionPoint.AllowsMultipleConnections.ToString() + 
       "<br />" + 
       "  Enabled: " + conn.ProviderConnectionPoint.GetEnabled(zip1).ToString() + 
       "<hr />" + 
       "<h3>Consumer Connection Point</h3>" + 
       "  Display name: " + conn.ConsumerConnectionPoint.DisplayName + 
       "<br />" + 
       "  ID: " + conn.ConsumerConnectionPoint.ID + 
       "<br />" + 
       "  Interface type: " + conn.ConsumerConnectionPoint.InterfaceType.ToString() + 
       "<br />" + 
       "  Control type: " + conn.ConsumerConnectionPoint.ControlType.ToString() + 
       "<br />" + 
       "  Allows multiple connections: " + 
          conn.ConsumerConnectionPoint.AllowsMultipleConnections.ToString() + 
       "<br />" + 
       "  Enabled: " + conn.ConsumerConnectionPoint.GetEnabled(zip1).ToString();
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    lblConn.Text = String.Empty;
  }
</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" >
        <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="Dynamic Connection" 
        OnClick="Button1_Click" />      
      <br />
      <asp:Button ID="Button2" runat="server" 
        Text="Connection Point Details" 
        OnClick="Button2_Click" />
      <br />
      <asp:Label ID="lblConn" 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" %>
    
<!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")

    If mgr.CanConnectWebParts(zip1, provPoint, weather1, connPoint) Then
      mgr.ConnectWebParts(zip1, provPoint, weather1, connPoint)
    End If
    
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Dim conn As WebPartConnection = mgr.Connections(0)

    lblConn.Text = "<h2>Connection Point Details</h2>" & _
      "<h3>Provider Connection Point</h3>" & _
      "  Display name: " & conn.ProviderConnectionPoint.DisplayName & _
      "<br />" & _
      "  ID: " & conn.ProviderConnectionPoint.ID & _
      "<br />" & _
      "  Interface type: " & conn.ProviderConnectionPoint.InterfaceType.ToString() & _
      "<br />" & _
      "  Control type: " & conn.ProviderConnectionPoint.ControlType.ToString() & _
      "<br />" & _
      "  Allows multiple connections: " & _
        conn.ProviderConnectionPoint.AllowsMultipleConnections.ToString() & _
      "<br />" & _
      "  Enabled: " & conn.ProviderConnectionPoint.GetEnabled(zip1).ToString() & _
      "<hr />" & _
      "<h3>Consumer Connection Point</h3>" & _
      "  Display name: " & conn.ConsumerConnectionPoint.DisplayName & _
      "<br />" & _
      "  ID: " & conn.ConsumerConnectionPoint.ID & _
      "<br />" & _
      "  Interface type: " & conn.ConsumerConnectionPoint.InterfaceType.ToString() & _
      "<br />" & _
      "  Control type: " & conn.ConsumerConnectionPoint.ControlType.ToString() & _
      "<br />" & _
      "  Allows multiple connections: " & _
        conn.ConsumerConnectionPoint.AllowsMultipleConnections.ToString() & _
      "<br />" & _
      "  Enabled: " & conn.ConsumerConnectionPoint.GetEnabled(zip1).ToString()
          
  End Sub

  Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    lblConn.Text = String.Empty
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" >
        <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="Dynamic Connection" 
        OnClick="Button1_Click" />      
      <br />
      <asp:Button ID="Button2" runat="server" 
        Text="Connection Point Details" 
        OnClick="Button2_Click" />
      <br />
      <asp:Label ID="lblConn" runat="server" />
    </div>
    </form>
</body>
</html>

Po načtení stránky v prohlížeči klikněte na tlačítko Podrobnosti spojovacího bodu . Zobrazí se informace o zprostředkovateli a bodech připojení příjemce vytvořených v deklarativním připojení. Potom pomocí ovládacího prvku rozevíracího seznamu Režim zobrazení přepněte stránku do režimu připojení. V nabídce sloves ovládacího prvku zprostředkovateleWebPart PSČ (reprezentované šipkou dolů v záhlaví) klikněte na příkaz připojit. Zobrazí se uživatelské rozhraní připojení vytvořené automaticky ovládacím <asp:connectionszone> prvku deklarovaným na stránce. Toto je další způsob vytvoření připojení (prostřednictvím uživatelského rozhraní) spolu s deklarativními a programovými metodami, které byly popsány výše. Kliknutím na tlačítko Odpojit ukončíte existující statické připojení. Klikněte na odkaz Vytvořit připojení k příjemci . Uživatelské rozhraní teď zobrazí ovládací prvek rozevíracího seznamu se seznamem zobrazovaného názvu spojovacího bodu příjemce. V rozevíracím seznamu vyberte spojovací bod a kliknutím na Připojit připojení dokončete . Pak znovu klikněte na Odpojit . Kliknutím na tlačítko Dynamické připojení vytvořte připojení prostřednictvím kódu programu. Pomocí ovládacího prvku Režim zobrazení vraťte stránku do režimu procházení. Znovu klikněte na tlačítko Podrobnosti spojovacího bodu , abyste znovu označili podrobnosti o objektu spojovacího bodu příjemce.

Příklad demonstroval navázání připojení a použití spojovacího bodu příjemce třemi způsoby: statické připojení deklarované ve značkách webové stránky; připojení vytvořené v kódu, který používal ConsumerConnectionPoint objekt, a připojení vytvořené uživatelem prostřednictvím uživatelského rozhraní připojení.

Poznámky

V každém připojení webových částí mezi dvěma serverovými ovládacími prvky musí mít každý ovládací prvek (mimo jiné) přidružený objekt spojovacího bodu, který mu umožňuje připojit se k druhému ovládacímu prvku a poskytovat nebo využívat data v závislosti na tom, zda je ovládací prvek určen jako poskytovatel nebo příjemce připojení. Objekt ConnectionPoint obecně obsahuje podrobnosti o tom, jak se ovládací prvek může připojit k jinému ovládacímu prvku, a typ dat, která může sdílet. Aby ovládací prvek v připojení působil jako příjemce, musí být ConsumerConnectionPoint jeho spojovacím bodem objekt. Podrobnosti o připojeních a spojovacích bodech webových částí najdete v tématech uvedených níže v části Viz také.

K vytvoření objektu ConsumerConnectionPoint je potřeba provést několik kroků:

1. Povolte ovládací prvek příjemce odkazovat na instanci rozhraní. Ovládací WebPart prvek nebo jiný serverový ovládací prvek (lze použít jakýkoli typ serverového ovládacího prvku, který bude přidán do WebPartZoneBase zóny) musí být schopen využívat data z konkrétní instance rozhraní. Ovládací prvek nemusí implementovat rozhraní; musí ho implementovat pouze poskytovatel. Příjemce může buď pracovat s přesným typem rozhraní, který obsluhuje poskytovatel, nebo, pokud ne, WebPartTransformer lze objekt použít k transformaci dat z typu rozhraní poskytovatele na typ, kterému příjemce rozumí. Typickým způsobem, jak povolit příjemce, je deklarovat privátní pole tak, aby obsahovalo odkaz na požadovaný typ rozhraní.

2. Identifikujte metodu zpětného volání. Metoda příjemce musí být identifikována jako metoda zpětného volání, aby bylo možné navázat spojení se zprostředkovatelem. Tato metoda načte instanci rozhraní, které zprostředkovatel implementuje, a přiřadí ji (například) k privátnímu poli vytvořenému v prvním kroku. Přístup webových částí pro identifikaci metody zpětného volání v příjemci je přidání ConnectionConsumer atributu metadat (definovaného ConnectionConsumerAttribute třídou) do metody, která přijímá instanci rozhraní. Po přidání atributu je jediným povinným parametrem zobrazovaný název, který se má použít pro spojovací bod příjemce. Je také možné přidat volitelné parametry, například ID.

3. Zpracování a výstup dat z instance rozhraní Proveďte jakékoli interní zpracování dat podle potřeby a pak obvykle ovládací prvek příjemce vykreslí data na stránku. Běžným způsobem je přepsat metodu ovládacího prvku OnPreRender .

   Poznámka

   Během synchronního požadavku by měl příjemce požadovat data přímo od poskytovatele během události nebo bezprostředně po ní PreRender . Pokud během asynchronního požadavku není volána metoda zpětného volání poskytovatele v žádném okamžiku během vykreslování, může vývojář předpokládat, že příjemci nebyla odeslána žádná data.

Jakmile je ovládací prvek vybaven tak, aby fungoval jako spotřebitel, může se ovládací prvek účastnit připojení (za předpokladu, že je také vybaven a k dispozici ovládací prvek poskytovatele). K vytvoření statického deklarativního připojení ve značkách webové stránky mohou vývojáři použít <asp:webpartconnection> element . ConnectionConsumer Pokud atribut ve zdrojovém kódu příjemce, který identifikuje metodu zpětného volání, určuje ID spojovacího bodu, musí být tato hodnota přiřazena atributu ConsumerConnectionPointID v elementu <asp:webpartconnection> na stránce. Důvodem, proč může vývojář zadat ID spojovacího bodu příjemce, je, pokud je v ovládacím prvku příjemce definováno více spojovacích bodů. Pokud není zadáno ID spojovacího bodu příjemce v ovládacím prvku příjemce, nemusí být atributu na stránce přiřazena ConsumerConnectionPointID ani hodnota, protože připojení se vytvoří pomocí výchozí hodnoty získané z DefaultID pole.

Pokud chtějí vývojáři vytvořit připojení v kódu, musí vytvořit nový ConsumerConnectionPoint objekt voláním GetConsumerConnectionPoints metody a předáním ID ovládacího prvku příjemce spolu s ID nebo indexem definovaného ConsumerConnectionPoint objektu v ovládacím prvku příjemce. ConsumerConnectionPoint Vrácený objekt spolu s odkazem na ovládací prvek příjemce, odkaz na ovládací prvek zprostředkovatele a odpovídající ProviderConnectionPoint objekt jsou předány ConnectWebParts do metody vytvoření nového WebPartConnection objektu.

I když můžou vývojáři používat body připojení příjemců jako součást navazování připojení buď deklarativně, nebo programově, uživatelé můžou také interagovat s body připojení příjemců a navazovat připojení prostřednictvím uživatelského rozhraní. Pokud vývojáři deklarují ConnectionsZone ovládací prvek na webové stránce, poskytuje uživatelům uživatelské rozhraní za běhu pro vytváření připojení. Pokud uživatelé vyberou ovládací prvek zprostředkovatele jako výchozí bod pro vytvoření připojení kliknutím na jeho příkaz připojit (mohli také zvolit příjemce; výsledné připojení není nijak rozdílné), v uživatelském rozhraní se jim zobrazí ovládací prvek rozevíracího seznamu se zobrazenými názvy dostupných spojovacích bodů příjemce (nebo bodů, pokud existuje více bodů), do kterých může zprostředkovatel odesílat data. Aby uživatelé mohli navázat připojení, musí vybrat spojovací bod příjemce.

Objekt ConsumerConnectionPoint se přidruží přímo k určitému ovládacímu prvku příjemce a uloží podrobnosti o připojení do vlastností, které dědí ze základní ConnectionPoint třídy. Například ve zděděné InterfaceType vlastnosti si bod připojení příjemce zachová typ rozhraní, které používá. Pokud poskytovatel i příjemce v připojení porozumí typu rozhraní, jsou ovládací prvky kompatibilní a umožňují vytvořit přímé připojení. Pokud zprostředkovatel a příjemce nemohou pracovat se stejným typem rozhraní, jsou nekompatibilní a musí použít WebPartTransformer objekt k překladu vlastnosti spojovacího InterfaceType bodu zprostředkovatele na typ, se kterým může příjemce pracovat. Další důležitou zděděnou vlastností je DisplayName vlastnost , která poskytuje popisný název, který se zobrazí v uživatelském rozhraní, aby uživatelé mohli při vytváření připojení zvolit bod připojení příjemce. Zobrazovaný název je povinný parametr, když vývojáři přidávají ConnectionConsumer atribut do metody zpětného volání v ovládacím prvku příjemce. Zděděná ID vlastnost je také užitečná, jak je uvedeno výše, protože poskytuje jedinečný identifikátor pro bod připojení příjemce v případě, že příjemce má více spojovacích bodů. Příjemce může mít v něm definovaných více ConsumerConnectionPoint objektů a v tomto případě, když vývojáři přidají ConnectionConsumer atribut do metody, měli by zadat hodnotu ID pro odlišení jednotlivých spojovacích bodů. Jednou z dalších zděděných vlastností je AllowsMultipleConnections vlastnost , která označuje, zda se spojovací bod příjemce může připojit k více zprostředkovatelům současně. Tato hodnota vlastnosti je false ve výchozím nastavení pro body připojení příjemce (zatímco výchozí true hodnota je pro spojovací body poskytovatele).

Třída ConsumerConnectionPoint přidá několik jedinečných metod ke členům, které dědí z ConnectionPoint třídy . Metoda SetObject vyvolá vlastní definovanou metodu zpětného volání příjemce k načtení instance rozhraní od zprostředkovatele. Metoda SupportsConnection vrátí logickou hodnotu, která označuje, jestli je spojovací bod schopen navázat připojení na základě aktuálního stavu přidruženého ovládacího prvku příjemce.

Konstruktory

ConsumerConnectionPoint(MethodInfo, Type, Type, String, String, Boolean)

Inicializuje novou instanci ConsumerConnectionPoint třídy.

Vlastnosti

AllowsMultipleConnections	Získá hodnotu, která označuje, zda spojovací bod podporuje více souběžných připojení. (Zděděno od ConnectionPoint)
ControlType	Type Získá serverový ovládací prvek, ke kterému je přidružen spojovací bod. (Zděděno od ConnectionPoint)
DisplayName	Získá řetězec, který slouží jako popisný zobrazovaný název představující spojovací bod v uživatelském rozhraní (UI). (Zděděno od ConnectionPoint)
ID	Získá řetězec, který obsahuje identifikátor spojovacího bodu. (Zděděno od ConnectionPoint)
InterfaceType	Získá typ rozhraní používané spojovací bod. (Zděděno od ConnectionPoint)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnabled(Control)	Vrátí hodnotu, která označuje, zda se spojovací bod může účastnit připojení. (Zděděno od ConnectionPoint)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SetObject(Control, Object)	Vyvolá metodu zpětného volání v ovládacím prvku příjemce a načte instanci rozhraní z ovládacího prvku zprostředkovatele.
SupportsConnection(Control, ConnectionInterfaceCollection)	Určuje, zda je bod připojení příjemce aktuálně schopen navázat připojení.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• WebPartConnection
• ProviderConnectionPoint
• ASP.NET ovládací prvky webových částí
• Přehled připojení webových částí