ConnectionsZone Klasse

Definition

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

Vererbung

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Beispiele

Im folgenden Codebeispiel wird die Verwendung des ConnectionsZone Steuerelements auf einer Webpartsseite veranschaulicht. Das Beispiel umfasst vier Teile:

• Ein Benutzersteuerelement, mit dem Sie die Anzeigemodi auf der Webseite wechseln können.

• Eine Quelldatei, die den Code für eine POSTLEITZAHL-Schnittstelle und zwei WebPart Steuerelemente enthält, die als Anbieter und Consumer für eine Verbindung fungieren.

• Eine Webseite, die alle Steuerelemente hostet, veranschaulicht, wie ein <asp:connectionszone> Element deklariert wird und eine Reihe von Eigenschaften für die Verbindungszone deklarativ und programmgesteuert festlegt.

• Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Der erste Teil dieses Codebeispiels ist das Benutzersteuerelement, mit dem Benutzer den Anzeigemodus auf einer Webseite wechseln können. Ausführliche Informationen zu Anzeigemodi und eine Beschreibung des Quellcodes in diesem Steuerelement finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webparts-Seite.

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

Der zweite Teil des Beispiels ist die Quelldatei mit der Schnittstelle und benutzerdefinierten Steuerelementen. Beachten Sie, dass das ZipCodeWebPart Steuerelement die IZipCode -Schnittstelle implementiert und ein ConnectionProvider -Attribut hinzufügt, damit das Steuerelement als Anbieter für eine Verbindung fungieren kann. Das WeatherWebPart Steuerelement verfügt über eine Methode, die mit einem ConnectionConsumer -Attribut gekennzeichnet ist, wobei es die IZipCode -Schnittstelle nutzt, sodass es als Consumer in einer Verbindung fungieren kann.

Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren. Sie können sie explizit kompilieren und die resultierende Assembly im Ordner Bin ihrer Website oder im globalen Assemblycache ablegen. Alternativ können Sie den Quellcode im Ordner App_Code Ihrer Website ablegen, wo er zur Laufzeit dynamisch kompiliert wird. In diesem Beispiel wird die dynamische Kompilierung verwendet. Eine exemplarische Vorgehensweise, die das Kompilieren veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.

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

Der dritte Teil des Beispielcodes ist die Webseite. Ganz oben befinden sich Register Direktiven für das Benutzersteuerelement und die benutzerdefinierten Steuerelemente, die in der Verbindung verwendet werden. Ein <asp:connectionszone> Element wird auf der Seite als Beispiel für die deklarative Verwendung des ConnectionsZone Steuerelements deklariert. Innerhalb des -Elements werden eine Reihe von Eigenschaften deklarativ festgelegt. Andere Eigenschaften in der Verbindungszone werden programmgesteuert im Abschnitt der <script> Seite festgelegt.

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

Laden Sie die Webseite in einen Browser. Verwenden Sie das Dropdownlistensteuerelement Anzeigemodus , um die Seite in den Verbindungsmodus zu wechseln. Klicken Sie im Menü Verben des Postleitzahlanbieter-Steuerelements (das Verbenmenü wird durch den Pfeil nach unten in der Titelleiste des Steuerelements angezeigt) auf das Verb verbinden. Ein ConnectionsZone Steuerelement wird angezeigt. Beachten Sie, dass auf der Benutzeroberfläche der Verbindung die Schaltfläche Verbindung beenden angezeigt wird. Die Verbindung wurde bereits im Markup der Seite deklariert, sodass die Steuerelemente bereits verbunden sind. Klicken Sie auf Verbindung beenden, und verwenden Sie dann erneut das Anzeigemodus-Steuerelement , um die Seite in den Browsermodus zurückzugeben. Kehren Sie als Nächstes die Seite in den Verbindungsmodus zurück, klicken Sie auf das Verbindungsverb in einem der Steuerelemente, und beachten Sie, dass auf der Verbindungsoberfläche jetzt ein Link angezeigt wird, mit dem Sie eine Verbindung zwischen den Steuerelementen herstellen können. Klicken Sie auf den Link, und verwenden Sie die Verbindungsoberfläche, um Verbindungspunkte auszuwählen und die Verbindung herzustellen.

Hinweise

Mithilfe des Webparts-Steuerelementsatzes können Sie zwei Serversteuerelemente aktivieren, um eine Verbindung herzustellen und Daten gemeinsam zu nutzen, wobei ein Steuerelement als Anbieter fungiert und das andere als Consumer der Daten fungiert. Bei den beiden Steuerelementen kann es sich WebPart um Steuerelemente oder andere Serversteuerelemente handeln, vorausgesetzt, sie sind für die Verarbeitung von Verbindungen konzipiert und befinden sich in einer WebPartZoneBase Zone. Weitere Informationen zu Webpartsverbindungen finden Sie in den WebPartConnection Übersichten und ConnectionPoint klassen sowie in der Übersicht über Webparts-Verbindungen.

Sofern die erforderlichen Steuerelemente und Bedingungen zum Herstellen einer Webparts-Verbindung vorhanden sind, ist es weiterhin erforderlich, die Steuerelemente tatsächlich zu verbinden. Es gibt drei Möglichkeiten, eine Verbindung zwischen Serversteuerelementen herzustellen: Deklarieren einer Verbindung in einer Webseite, Erstellen einer Verbindung im Code oder Hinzufügen eines ConnectionsZone Steuerelements zur Seite, damit Benutzer die Steuerelemente bei Bedarf verbinden können. Das ConnectionsZone Steuerelement generiert eine Benutzeroberfläche, mit der Benutzer Serversteuerelemente auf einer Seite verbinden oder trennen können, die die bedingungen erfüllen, die zum Herstellen einer Verbindung erforderlich sind. Es handelt sich um ein optionales Steuerelement, das nicht zum Herstellen von Verbindungen erforderlich ist, aber nützlich ist, wenn Sie Benutzern die Kontrolle darüber geben möchten, welche Serversteuerelemente verbunden oder getrennt sind.

Das ConnectionsZone Steuerelement ist eines der Webparts-Toolzonensteuerelemente, die von der Basisklasse erben ToolZone . Als Toolzone ist das Steuerelement nur sichtbar, wenn sich seine ConnectionsZone Webseite in einem bestimmten Anzeigemodus befindet. In diesem Fall heißt der Anzeigemodus Verbindungsmodus (eine Seite befindet sich in diesem Modus, wenn der WebPartManager -Eigenschaftswert des Steuerelements auf der Seite auf ConnectDisplayModefestgelegt istDisplayMode). Nachdem Benutzer eine Seite in den Verbindungsmodus gewechselt haben, müssen sie im Verbenmenü eines der Serversteuerelemente auf ein Verbindungsverb klicken, und dann wird die Verbindungs-Ui sichtbar.

Als Webparts-Zonensteuerelement ist das ConnectionsZone Steuerelement ein Zonentyp WebZone (der von der -Klasse erbt), der CompositeControl so konzipiert ist, dass es andere Steuerelemente enthält. Im Allgemeinen enthält eine ConnectionsZone Zone die meisten elemente wie andere Webpart-Toolzonen: einen Header, einen Text- oder Inhaltsbereich und eine Fußzeile. Eine vollständige Erläuterung der Bedeutung einer Webpartszone und der verschiedenen Teile einer Zone finden Sie in der WebZone Klassenübersicht.

Wenn das ConnectionsZone Steuerelement gerendert wird, generiert es eine Benutzeroberfläche basierend auf den Serversteuerelementen auf der Seite, die Verbindungen bilden können. Das ConnectionsZone Steuerelement bestimmt, welche Serversteuerelemente in der WebPartZoneBase Zone auf der Seite Anbieter sind, welche Consumer sind, welche Verbindungspunkte verfügbar sind und ob die Serversteuerelemente derzeit verbunden oder getrennt sind, und generiert dann die Benutzeroberfläche entsprechend.

Angenommen, es gibt ein WebPart Steuerelement, das ein Anbieter sein kann, ein WebPart Steuerelement, das ein Consumer sein kann, in einem WebPartZone auf der Seite deklariert wird und derzeit getrennt ist. Wenn ein Benutzer die Seite in den Verbindungsmodus wechselt und auf das Verbindungsverb in einem der Steuerelemente klickt, generiert das Steuerelement eine Benutzeroberfläche mit einem Link, der ConnectionsZone bei Klick ein Formular anzeigt, in dem Benutzer Optionen zum Erstellen einer Verbindung auswählen können. (Wenn die Steuerelemente zuvor verbunden waren, wird benutzern in der ersten Ansicht stattdessen eine Schaltfläche zum Trennen der Steuerelemente angezeigt.) Auf der Verbindungsoberfläche zum Erstellen neuer Verbindungen wird Benutzern angezeigt, welches Steuerelement ein Anbieter und welches Steuerelement ein Consumer ist. Unter jedem Serversteuerelement wird ein Dropdownlistensteuerelement angezeigt, in dem die für das Steuerelement verfügbaren ConnectionPoint Objekte aufgelistet sind. In den jeweiligen Dropdownlisten müssen Benutzer ein ProviderConnectionPoint Objekt für den Anbieter (um zu bestimmen, welche Schnittstelle und Daten für Consumer freigegeben werden) und ein ConsumerConnectionPoint Objekt für jeden Consumer (um zu bestimmen, welche Schnittstelle und Daten der Consumer nutzen wird) auswählen, das mit dem Anbieter verbunden wird.

Um das ConnectionsZone Steuerelement zu verwenden, können Sie es innerhalb des <form> Elements auf einer Webseite deklarieren (aber nicht in einem anderen Webpart-Zonenelement geschachtelt), indem Sie das <asp:connectionszone> -Element verwenden, oder Sie können es programmgesteuert der Seite hinzufügen. Wenn Sie das Element auf einer Seite deklarieren, können Sie im Gegensatz zu den anderen Webparts-Zonen keine anderen Serversteuerelemente zwischen den Tags des <asp:connectionszone> Elements deklarieren. Sie können darin Elemente deklarieren, die sich auf ihre eigenen Eigenschaften und Stildetails beziehen, es handelt sich jedoch um ein eigenständiges Element und kein Vorlagensteuerelement, in dem andere Serversteuerelemente deklariert werden können.

Das ConnectionsZone Steuerelement verfügt über eine Reihe von Eigenschaften, die zum Rendern der Benutzeroberfläche für die Verbindung verwendet werden. Eine Gruppe von Eigenschaften enthält mehrere Verben , die nur in Bezug auf Verbindungen verwendet werden, die Aktionen auf der Benutzeroberfläche ausführen: ConfigureVerb, ConnectVerbund DisconnectVerb. Ein großer Satz von Eigenschaften, die speziell für die Benutzeroberfläche der Verbindungszone verwendet werden, besteht aus Textzeichenfolgen, die an verschiedenen Stellen (oder in bestimmten Situationen, z. B. bei Auftreten von Fehlern) auf der Benutzeroberfläche angezeigt werden: , , , NewConnectionErrorMessageProvidersTitleNoExistingConnectionInstructionTextConnectToConsumerTitleConnectToProviderTitleConnectToConsumerTextConnectToProviderInstructionTextConsumersTitleSendTextProvidersInstructionTextNoExistingConnectionTitleGetFromTextConnectToProviderTextInstructionTitleExistingConnectionErrorMessageConsumersInstructionTextGetTextund .SendToTextConnectToConsumerInstructionTextConfigureConnectionTitle Die ConnectionsZone -Klasse enthält auch eine Reihe von allgemeinen Eigenschaften in anderen Webparts-Zonen: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderTextInstructionText, und PartChromeType. Schließlich ist die WebPartToConnect -Eigenschaft für die -Klasse eindeutig und verweist auf das Steuerelement, das die Verbindung initiiert (dies ist das Steuerelement, auf das der Benutzer in seinem Verbenmenü auf das Verbindungsverb klickt, das auch das Steuerelement ist, auf das in der -Eigenschaft des WebPartManager Steuerelements SelectedWebPart verwiesen wird).

Die ConnectionsZone -Klasse verfügt auch über eine Reihe von Methoden, die alle von Basisklassen geerbt und überschrieben werden, und die meisten von ihnen stammen aus den grundlegenden Webparts-Zonenklassen. Weitere Informationen finden Sie in den einzelnen Methoden.

Hinweise für Vererber

Die ConnectionsZone -Klasse kann erweitert werden, wenn Entwickler ihr Verhalten oder die Standard-Ui ändern möchten, die sie für die Arbeit mit Verbindungen bereitstellt.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• ASP.NET Webparts-Steuerelemente
• Übersicht über Webpartsverbindungen