ConnectionsZone Sınıf

Tanım

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

Devralma

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

ConnectionsZone

Örnekler

Aşağıdaki kod örneği, Web Bölümleri sayfasında denetimin ConnectionsZone nasıl kullanılacağını gösterir. Örnekte dört bölüm vardır:

• Web sayfasında görüntüleme modlarını değiştirmenizi sağlayan bir kullanıcı denetimi.

• Posta Kodu arabiriminin kodunu içeren bir kaynak dosya ve bağlantı için sağlayıcı ve tüketici olarak davranan iki WebPart denetim.

• Tüm denetimleri barındıran, bir <asp:connectionszone> öğenin nasıl bildirildiğini gösteren ve bağlantı bölgesi üzerinde bildirimli ve programlı olarak bir dizi özellik ayarlayan bir Web sayfası.

• Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Bu kod örneğinin ilk bölümü, kullanıcıların Bir Web sayfasında görüntüleme modlarını değiştirmesini sağlayan kullanıcı denetimidir. Bu denetimdeki görüntü modları ve kaynak kodun açıklaması hakkında ayrıntılı bilgi için bkz . İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

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

Örneğin ikinci bölümü, arabirimi ve özel denetimleri olan kaynak dosyasıdır. Denetimin ZipCodeWebPart arabirimini uyguladığına ve denetimin IZipCode bir ConnectionProvider bağlantı için sağlayıcı olarak hareket edebilmesi için bir öznitelik ekleyerek dikkat edin. DenetiminWeatherWebPart, arabirimini tükettiği IZipCode bir öznitelikle işaretlenmiş bir ConnectionConsumer yöntemi vardır, böylece bir bağlantıda tüketici olarak hareket edebilir.

Kod örneğinin çalışması için bu kaynak kodunu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin App_Code klasörüne koyabilirsiniz; burada çalışma zamanında dinamik olarak derlenir. Bu örnekte dinamik derleme kullanılır. Derlemeyi gösteren bir izlenecek yol için bkz . İzlenecek Yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

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

Örnek kodun üçüncü bölümü Web sayfasıdır. Üst kısımda kullanıcı denetimine ve bağlantıda kullanılan özel denetimlere yönelik yönergeler bulunur Register . Öğe <asp:connectionszone> , denetimi bildirimli olarak kullanmanın ConnectionsZone bir örneği olarak sayfada bildirilir. öğesinde, bir dizi özellik bildirimli olarak ayarlanır. Bağlantılar bölgesindeki diğer özellikler, sayfanın bölümünde program aracılığıyla <script> ayarlanır.

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

Web sayfasını bir tarayıcıya yükleyin. Sayfayı bağlantı moduna geçmek için Görüntü Modu açılan liste denetimini kullanın. Posta Kodu Sağlayıcısı denetiminin fiiller menüsünde (fiiller menüsü, denetimin başlık çubuğundaki aşağı okla gösterilir), bağlanma fiiline tıklayın. Bir ConnectionsZone denetim görüntülenir. Bağlantı kullanıcı arabiriminde bir Bağlantıyı Sonlandır düğmesinin göründüğüne dikkat edin; bağlantı, sayfanın işaretlemesinde zaten bildirilmiştir, bu nedenle denetimler zaten bağlantılıdır. Bağlantıyı Sonlandır'a tıklayın ve sayfayı göz atma moduna döndürmek için Görüntü Modu denetimini yeniden kullanın. Ardından, bağlantı moduna geçmek için sayfayı yeniden döndürüp denetimlerden birinde bağlantı fiiline tıklayın ve bağlantı kullanıcı arabiriminde artık denetimler arasında bağlantı oluşturmanıza olanak tanıyan bir köprü görüntülendiğini unutmayın. Bağlantıya tıklayın ve bağlantı noktalarını seçmek ve bağlantıyı kurmak için bağlantı kullanıcı arabirimini kullanın.

Açıklamalar

Web Bölümleri denetim kümesini kullanarak, iki sunucu denetiminin bir bağlantı oluşturmasını ve verileri paylaşmasını sağlayabilirsiniz. Bu denetimlerden biri sağlayıcı, diğeri ise verilerin tüketicisi olarak hareket eder. İki denetim, bağlantıları işlemek için tasarlanmış olmaları ve bir bölgede ikamet etmeleri koşuluyla denetimler veya başka bir WebPartZoneBase tür sunucu denetimi olabilirWebPart. Web Bölümleri bağlantıları hakkında daha fazla bilgi edinmek için ve ConnectionPoint sınıfına WebPartConnection genel bakışlara ve Web Bölümleri Bağlantılarına Genel Bakış'a bakın.

Web Bölümleri bağlantısı oluşturmak için gerekli denetimlerin ve koşulların mevcut olması koşuluyla, denetimlerin gerçekten bağlanması yine de gereklidir. Sunucu denetimleri arasında bağlantı oluşturmanın üç yolu vardır: Web sayfasında bağlantı bildirme, kodda bağlantı oluşturma veya kullanıcıların isteğe bağlı olarak denetimleri bağlayabilmesi için sayfaya denetim ekleme ConnectionsZone . Denetim, ConnectionsZone kullanıcıların bir sayfadaki bağlantı oluşturmak için gereken koşulları karşılayan sunucu denetimlerine bağlanmasını veya bağlantısını kesmesini sağlayan bir kullanıcı arabirimi oluşturur. Bu, bağlantıları oluşturmak için gerekli olmayan isteğe bağlı bir denetimdir, ancak kullanıcılara hangi sunucu denetimlerinin bağlı veya bağlantısı kesildiği üzerinde denetim vermek istediğinizde kullanışlıdır.

Denetim ConnectionsZone , temel sınıftan devralan Web Bölümleri araç bölgesi denetimlerinden ToolZone biridir. Bir araç bölgesi olarak, ConnectionsZone denetim yalnızca Web sayfası belirli bir görüntüleme modunda olduğunda görünür olacak şekilde tasarlanmıştır. Bu durumda, görüntüleme modu bağlantı modu olarak adlandırılır (sayfadaki denetimin WebPartManager özellik değeri olarak ayarlandığında ConnectDisplayModesayfa DisplayMode bu moddadır). Kullanıcılar bir sayfayı bağlantı moduna geçirdikten sonra, sunucu denetimlerinden birinin fiiller menüsünde bir bağlantı fiiline tıklamaları gerekir ve ardından bağlantı kullanıcı arabirimi görünür hale gelir.

Web Bölümleri bölge denetimi olarak denetim, ConnectionsZone diğer denetimleri içerecek şekilde tasarlanmış bir bölge türüdür WebZone (sınıftan CompositeControl devralınır). Genel olarak, bir ConnectionsZone bölge diğer Web Bölümleri araç bölgeleriyle aynı öğelerin çoğuna sahiptir: üst bilgi, gövde veya içerik alanı ve alt bilgi. Web Bölümleri bölgesinin ne olduğu ve bölgenin farklı bölümleri hakkında ayrıntılı bilgi için sınıfa genel bakış konusuna WebZone bakın.

ConnectionsZone Denetim işlendiğinde, sayfadaki bağlantı oluşturabilen sunucu denetimlerini temel alan bir kullanıcı arabirimi oluşturur. Denetim ConnectionsZone , sayfadaki bölgede WebPartZoneBase hangi sunucu denetimlerinin sağlayıcılar olduğunu, hangilerinin tüketici olduğunu, hangi bağlantı noktalarının kullanılabilir olduğunu ve sunucu denetimlerinin şu anda bağlı veya bağlantısız olup olmadığını belirler ve ardından kullanıcı arabirimini buna göre oluşturur.

Örneğin, sağlayıcı olma özelliğine sahip tek WebPart bir denetim olduğunu, tüketici olma yeteneğine sahip bir WebPart denetimin olduğunu, bunların sayfada bir WebPartZone olarak bildirildiğini ve şu anda bağlantılarının kesildiğini varsayalım. Kullanıcı sayfayı bağlantı moduna geçtiğinde ve denetimlerden birinde bağlantı fiiline tıkladığında, ConnectionsZone denetim tıklandığında kullanıcıların bağlantı oluşturma seçeneklerini belirleyebileceği bir form görüntüleyen bir bağlantı içeren bir kullanıcı arabirimi oluşturur. (Denetimler daha önce bağlıysa, ilk görünüm bunun yerine kullanıcılara denetimlerin bağlantısını kesmek için bir düğme gösterir). Yeni bağlantılar oluşturmak için bağlantı kullanıcı arabiriminde, kullanıcılara hangi denetimin sağlayıcı ve hangi denetimin tüketici olduğu gösterilir. Her sunucu denetiminin altında, denetim için kullanılabilir ConnectionPoint nesneleri listeleyen bir açılan liste denetimi görüntülenir. İlgili açılan listelerden kullanıcıların sağlayıcı için bir ProviderConnectionPoint nesne (tüketicilerle hangi arabirimin ve verilerin paylaşılacağını belirlemek için) ve sağlayıcıya bağlanacak her tüketici için bir ConsumerConnectionPoint nesne (tüketicinin hangi arabirimi ve verileri kullanacağını belirlemek için) seçmesi gerekir.

Denetimi kullanmak ConnectionsZone için, öğeyi kullanarak <asp:connectionszone> web sayfasındaki öğe içinde <form> bildirebilir (ancak başka bir Web Bölümleri bölge öğesi içinde iç içe yerleştiremezsiniz) veya bunu program aracılığıyla sayfaya ekleyebilirsiniz. Bir sayfadaki öğeyi bildirirseniz, diğer Web Bölümleri bölgelerinden farklı olarak, öğenin etiketleri <asp:connectionszone> arasında başka bir tür sunucu denetimi bildiremezsiniz. Kendi özellikleri ve stil ayrıntılarıyla ilişkili öğeleri içinde bildirebilirsiniz, ancak bu tek başına bir öğedir ve diğer sunucu denetimlerinin bildirilebileceği bir şablon denetimi değildir.

Denetim, ConnectionsZone bağlantı kullanıcı arabirimini işlemek için kullandığı bir dizi özelliğe sahiptir. Bir özellik kümesi, yalnızca bağlantılarla ilgili olarak kullanılan ve kullanıcı arabiriminde eylemler gerçekleştiren çeşitli fiiller içerir: ConfigureVerb, ConnectVerbve DisconnectVerb. Özellikle bağlantı bölgesi kullanıcı arabirimi için kullanılan büyük bir özellik kümesi, kullanıcı arabiriminde çeşitli yerlerde (veya hatalar oluştuğunda gibi bazı durumlarda) görüntülenen metin dizelerinden oluşur: ConfigureConnectionTitle, , , ConnectToConsumerText, ConnectToConsumerTitle, , ConnectToProviderInstructionText, ConnectToProviderText, ProvidersTitleConsumersInstructionTextConnectToProviderTitleConsumersTitleGetFromTextExistingConnectionErrorMessageGetTextNoExistingConnectionTitleSendTextInstructionTitleNewConnectionErrorMessageNoExistingConnectionInstructionTextProvidersInstructionTextve .SendToTextConnectToConsumerInstructionText ConnectionsZone sınıfı, diğer Web Bölümleri bölgelerinde bulunan bir dizi ortak özelliği de içerir: CancelVerb, CloseVerb, Display, EmptyZoneText, HeaderText, , InstructionTextve PartChromeType. Son olarak, WebPartToConnect özelliği sınıfına özgüdür ve bağlantıyı başlatan denetime başvurur (bu, kullanıcının fiil menüsünde bağlantı fiiline tıkladığı denetimdir ve bu da denetimin SelectedWebPart özelliğinde WebPartManager başvurulan denetimdir).

sınıfı ConnectionsZone , tümü temel sınıflardan devralınan ve geçersiz kılınan ve çoğu temel Web Bölümleri bölge sınıflarından gelen bir dizi yönteme de sahiptir. Ayrıntılar için tek tek yöntemlere bakın.

Devralanlara Notlar

ConnectionsZone Geliştiriciler davranışını veya bağlantılarla çalışmak için sağladığı varsayılan kullanıcı arabirimini değiştirmek isterse sınıf genişletilebilir.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• WebZone
• WebPartConnection
• ConnectionPoint
• WebPartZoneBase
• Web Bölümleri Denetimlerini ASP.NET
• Web Bölümleri Bağlantılarına Genel Bakış