ConnectionsZone Třída

Definice

public ref class ConnectionsZone : System::Web::UI::WebControls::WebParts::ToolZone

public class ConnectionsZone : System.Web.UI.WebControls.WebParts.ToolZone

type ConnectionsZone = class
    inherit ToolZone

Public Class ConnectionsZone
Inherits ToolZone

Dědičnost

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Příklady

Následující příklad kódu ukazuje, jak použít ConnectionsZone ovládací prvek na stránce webových částí. Příklad má čtyři části:

• Uživatelský ovládací prvek, který umožňuje přepínat režimy zobrazení na webové stránce.

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

• Webová stránka, která je hostitelem všech ovládacích prvků, ukazuje, jak deklarovat <asp:connectionszone> prvek a deklarativně a programově nastaví řadu vlastností v zóně připojení.

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

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje uživatelům přepínat režimy zobrazení na webové stránce. 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 je zdrojový soubor s rozhraním a vlastními ovládacími prvky. Všimněte si, že ZipCodeWebPart ovládací prvek implementuje IZipCode rozhraní a přidává ConnectionProvider atribut, aby ovládací prvek mohl fungovat jako zprostředkovatel připojení. Ovládací WeatherWebPart prvek má metodu označenou atributem ConnectionConsumer , kde využívá IZipCode rozhraní, takže může v připojení fungovat jako 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 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í ukázkového kódu je webová stránka. V horní části jsou Register direktivy pro uživatelský ovládací prvek a vlastní ovládací prvky použité v připojení. Element <asp:connectionszone> je deklarován na stránce jako příklad použití ConnectionsZone ovládacího prvku deklarativně. V rámci elementu je několik vlastností nastaveno deklarativně. Další vlastnosti v zóně připojení se nastavují programově v <script> části stránky.

<%@ 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 Page_PreRender(object sender, EventArgs e)
  {
     // Set properties on verbs.
     connectionsZone1.CancelVerb.Description = 
       "Terminates the connection process";
     connectionsZone1.CloseVerb.Description = 
       "Closes the connections UI";
     connectionsZone1.ConfigureVerb.Description =
       "Configure the transformer for the connection";
     connectionsZone1.ConnectVerb.Description =
       "Connect two WebPart controls";
     connectionsZone1.DisconnectVerb.Description =
       "End the connection between two controls";
    
     // Set properties for UI text strings.
     connectionsZone1.ConfigureConnectionTitle = 
       "Configure";
     connectionsZone1.ConnectToConsumerInstructionText = 
       "Choose a consumer connection point";
     connectionsZone1.ConnectToConsumerText = 
       "Select a consumer for the provider to connect with";
     connectionsZone1.ConnectToConsumerTitle = 
       "Send data to this consumer";
     connectionsZone1.ConnectToProviderInstructionText =
       "Choose a provider connection point";
     connectionsZone1.ConnectToProviderText =
       "Select a provider for the consumer to connect with";
     connectionsZone1.ConnectToProviderTitle =
       "Get data from this provider";
     connectionsZone1.ConsumersInstructionText = 
       "WebPart controls that receive data from providers";
     connectionsZone1.ConsumersTitle = "Consumer Controls";
     connectionsZone1.GetFromText = "Receive from";
     connectionsZone1.GetText = "Retrieve";
     connectionsZone1.HeaderText = 
      "Create and Manage Connections";
     connectionsZone1.InstructionText = 
      "Manage connections for the selected WebPart control";
     connectionsZone1.InstructionTitle = 
       "Manage connections for consumers or providers";
     connectionsZone1.NoExistingConnectionInstructionText = 
       "No connections exist. Click the above link to create "
       + "a connection.";
     connectionsZone1.NoExistingConnectionTitle = 
       "No current connections";
     connectionsZone1.ProvidersInstructionText =
       "WebPart controls that send data to consumers";
     connectionsZone1.ProvidersTitle = "Provider controls";
     
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenucs id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider"  />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </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 Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Set properties for verbs.
    connectionsZone1.CancelVerb.Description = _
      "Terminates the connection process"
    connectionsZone1.CloseVerb.Description = _
      "Closes the connections UI"
    connectionsZone1.ConfigureVerb.Description = _
      "Configure the transformer for the connection"
    connectionsZone1.ConnectVerb.Description = _
      "Connect two WebPart controls"
    connectionsZone1.DisconnectVerb.Description = _
      "End the connection between two controls"
    
    ' Set properties for UI text strings.
    connectionsZone1.ConfigureConnectionTitle = _
      "Configure a new connection"
    connectionsZone1.ConnectToConsumerInstructionText = _
      "Choose a consumer connection point"
    connectionsZone1.ConnectToConsumerText = _
      "Select a consumer for the provider to connect with"
    connectionsZone1.ConnectToConsumerTitle = _
      "Send data to this consumer"
    connectionsZone1.ConnectToProviderInstructionText = _
      "Choose a provider connection point"
    connectionsZone1.ConnectToProviderText = _
      "Select a provider for the consumer to connect with"
    connectionsZone1.ConnectToProviderTitle = _
      "Get data from this provider"
    connectionsZone1.ConsumersInstructionText = _
      "WebPart controls that receive data from providers"
    connectionsZone1.ConsumersTitle = "Consumer Controls"
    connectionsZone1.GetFromText = "Receive from"
    connectionsZone1.GetText = "Retrieve"
    connectionsZone1.HeaderText = _
      "Create and Manage Connections"
    connectionsZone1.InstructionText = _
      "Manage connections for the selected WebPart control"
    connectionsZone1.InstructionTitle = _
      "Manage connections for consumers or providers"
    connectionsZone1.NoExistingConnectionInstructionText = _
      "No connections exist. Click the above link to create " _
      & "a connection."
    connectionsZone1.NoExistingConnectionTitle = _
      "No current connections"
    connectionsZone1.ProvidersInstructionText = _
      "WebPart controls that send data to consumers"
    connectionsZone1.ProvidersTitle = "Provider controls"

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenuvb id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider" />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

Načtěte webovou stránku v prohlížeči. 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ředkovatele PSČ (nabídka sloves je označená šipkou dolů v záhlaví ovládacího prvku) klikněte na příkaz připojit. Zobrazí ConnectionsZone se ovládací prvek. Všimněte si, že v uživatelském rozhraní připojení se zobrazí tlačítko Ukončit připojení ; připojení již bylo deklarováno v kódu stránky, takže ovládací prvky jsou již připojeny. Klikněte na Ukončit připojení a pak znovu pomocí ovládacího prvku Režim zobrazení vraťte stránku do režimu procházení. V dalším kroku vraťte stránku do režimu připojení, klikněte na příkaz připojit u jednoho z ovládacích prvků a všimněte si, že uživatelské rozhraní připojení teď zobrazí hypertextový odkaz, který umožňuje vytvořit spojení mezi ovládacími prvky. Klikněte na odkaz a pomocí uživatelského rozhraní pro připojení vyberte spojovací body a navazujte připojení.

Poznámky

Pomocí sady ovládacích prvků webové části můžete povolit, aby dva serverové ovládací prvky vytvořily připojení a sdílely data, přičemž jeden ovládací prvek funguje jako zprostředkovatel a druhý jako příjemce dat. Tyto dva ovládací prvky mohou být WebPart ovládací prvky nebo jakýkoli jiný typ serverového ovládacího prvku za předpokladu, že jsou navrženy pro zpracování připojení a že se nacházejí v WebPartZoneBase zóně. Další informace o připojeních webových částí najdete v WebPartConnection přehledech tříd a ConnectionPoint a také v tématu Přehled připojení webových částí.

Za předpokladu, že existují požadované ovládací prvky a podmínky pro vytvoření připojení webových částí, je stále nutné ovládací prvky skutečně připojit. Existují tři způsoby, jak vytvořit spojení mezi serverovými ovládacími prvky: deklarování připojení na webové stránce, vytvoření připojení v kódu nebo přidání ConnectionsZone ovládacího prvku na stránku, aby uživatelé mohli připojit ovládací prvky na vyžádání. Ovládací ConnectionsZone prvek vygeneruje uživatelské rozhraní, které uživatelům umožňuje připojit nebo odpojit všechny serverové ovládací prvky na stránce, které splňují podmínky nezbytné pro vytvoření připojení. Jedná se o volitelný ovládací prvek, který není nutný k vytvoření připojení, ale je užitečný v případě, že chcete uživatelům poskytnout kontrolu nad tím, které ovládací prvky serveru jsou připojené nebo odpojené.

Ovládací ConnectionsZone prvek je jedním z ovládacích prvků zóny nástroje webové části, které dědí ze ToolZone základní třídy. Jako zóna nástrojů je ovládací prvek navržen tak, aby byl viditelný pouze v případě, ConnectionsZone že je jeho webová stránka v určitém režimu zobrazení. V tomto případě se režim zobrazení nazývá režim připojení (stránka je v tomto režimu, když WebPartManager má ovládací prvek na stránce hodnotu DisplayMode vlastnosti nastavenou na ConnectDisplayMode). Jakmile uživatelé přepnou stránku do režimu připojení, musí kliknout na příkaz připojit v nabídce sloves některého ze serverových ovládacích prvků a pak se uživatelské rozhraní připojení zobrazí.

Jako ovládací prvek zóny webových částí je ovládací prvek typem WebZone zóny (která dědí z CompositeControl třídy) navržený tak, ConnectionsZone aby obsahoval další ovládací prvky. Obecně platí, že ConnectionsZone zóna obsahuje většinu stejných prvků jako ostatní zóny nástrojů webových částí: záhlaví, oblast obsahu nebo obsahu a zápatí. Úplnou diskuzi o tom, co je zóna webových částí a o různých částech zóny, najdete v přehledu WebZone třídy.

Při vykreslení ConnectionsZone ovládacího prvku vygeneruje uživatelské rozhraní založené na serverových ovládacích prvcích na stránce, které jsou schopné vytvořit připojení. Ovládací ConnectionsZone prvek určuje, které ovládací prvky serveru v WebPartZoneBase zóně na stránce jsou poskytovateli, které jsou spotřebiteli, které body připojení jsou k dispozici a zda jsou ovládací prvky serveru aktuálně připojeny nebo odpojeny, a poté vygeneruje uživatelské rozhraní odpovídajícím způsobem.

Předpokládejme například, že existuje jeden WebPart ovládací prvek, který může být zprostředkovatelem, jeden WebPart ovládací prvek schopný být příjemcem, jsou deklarovány v objektu WebPartZone na stránce a jsou aktuálně odpojené. Když uživatel přepne stránku do režimu připojení a klikne na příkaz připojit na jednom z ovládacích prvků, ConnectionsZone ovládací prvek vygeneruje uživatelské rozhraní s odkazem, který po kliknutí zobrazí formulář, ve kterém mohou uživatelé zvolit možnosti pro vytvoření připojení. (Pokud byly ovládací prvky dříve připojeny, zobrazí se uživatelům v počátečním zobrazení tlačítko pro odpojení ovládacích prvků.) V uživatelském rozhraní připojení pro vytváření nových připojení se uživatelům zobrazí, který ovládací prvek je zprostředkovatel a který ovládací prvek je příjemce. Pod každým serverovým ovládacím prvku se zobrazí ovládací prvek rozevíracího seznamu se seznamem dostupných ConnectionPoint objektů pro ovládací prvek. V příslušných rozevíracích seznamech musí uživatelé vybrat jeden ProviderConnectionPoint objekt pro zprostředkovatele (aby bylo možné určit, jaké rozhraní a data budou sdílena se spotřebiteli) a jeden ConsumerConnectionPoint objekt pro každého příjemce (aby bylo možné určit, jaké rozhraní a data bude příjemce využívat), který bude připojen k poskytovateli.

Pokud chcete ovládací prvek použít ConnectionsZone , můžete ho deklarovat v rámci elementu <form> na webové stránce (ale ne vnořený do jiného prvku zóny webových částí) pomocí elementu <asp:connectionszone> nebo ho můžete přidat na stránku programově. Pokud deklarujete prvek na stránce, na rozdíl od jiných zón webových částí, nelze deklarovat žádný jiný typ serverových ovládacích prvků mezi značkami elementu <asp:connectionszone> . Můžete v něm deklarovat prvky, které se vztahují k jeho vlastním vlastnostem a podrobnostem o stylu, ale je to samostatný prvek a není to ovládací prvek šablony, ve kterém lze deklarovat jiné serverové ovládací prvky.

Ovládací ConnectionsZone prvek má řadu vlastností, které používá pro vykreslení uživatelského rozhraní připojení. Jedna sada vlastností obsahuje několik sloves – používaných pouze ve vztahu k připojením – které provádějí akce v uživatelském rozhraní: ConfigureVerb, ConnectVerba DisconnectVerb. Velká sada vlastností, která se používá zejména pro uživatelské rozhraní zóny připojení, se skládá z textových řetězců zobrazených na různých místech (nebo v určitých situacích, například když dojde k chybám) v uživatelském rozhraní: ConfigureConnectionTitle, ConnectToConsumerInstructionText, ConnectToProviderTitleNoExistingConnectionTitleConnectToConsumerTextExistingConnectionErrorMessageConsumersTitleGetFromTextConsumersInstructionTextGetTextConnectToProviderTextInstructionTitleNewConnectionErrorMessageConnectToProviderInstructionTextConnectToConsumerTitleProvidersInstructionTextProvidersTitleNoExistingConnectionInstructionTextSendTexta .SendToText Třída ConnectionsZone obsahuje také řadu společných vlastností nalezených v jiných zónách webových částí: CancelVerb, , DisplayCloseVerb, EmptyZoneText, HeaderTextInstructionText, a PartChromeType. WebPartToConnect Nakonec je vlastnost jedinečná pro třídu a odkazuje na ovládací prvek, který inicializuje připojení (jedná se o ovládací prvek, u kterého uživatel klikne na příkaz connect v nabídce sloves, což je také ovládací prvek odkazovaný ve WebPartManager vlastnosti ovládacího prvkuSelectedWebPart).

Třída ConnectionsZone má také řadu metod, z nichž všechny jsou zděděné a přepsány ze základních tříd, a většina z nich pochází ze základních tříd zóny webových částí. Podrobnosti najdete v jednotlivých metodách.

Poznámky pro dědice

Třídu ConnectionsZone lze rozšířit, pokud vývojáři chtějí změnit její chování nebo výchozí uživatelské rozhraní, které poskytuje pro práci s připojeními.

Konstruktory

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

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