ProviderConnectionPoint Sınıf

Tanım

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

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

type ProviderConnectionPoint = class
    inherit ConnectionPoint

Public Class ProviderConnectionPoint
Inherits ConnectionPoint

Devralma

Object

ConnectionPoint

ProviderConnectionPoint

Örnekler

Aşağıdaki kod örneği, her durumda sağlayıcı bağlantı noktasını kullanarak bildirim temelli, programlı veya kullanıcı arabirimi aracılığıyla bağlantı oluşturmanın basit yollarını gösterir.

Örnekte dört bölüm vardır:

• Sayfadaki Web Bölümleri görüntüleme modunu değiştirmenize olanak tanıyan bir kullanıcı denetimi.

• Bir arabirim ve bir bağlantı için sağlayıcı ve tüketici olarak davranan iki WebPart denetimin kaynak kodu.

• Tüm denetimleri barındırmak ve kod örneğini çalıştırmak için bir Web sayfası.

• Örnek sayfayı çalıştırmanın açıklaması.

Bu kod örneğinin ilk bölümü, kullanıcıların Web sayfasındaki görüntü modlarını değiştirmesine olanak tanıyan kullanıcı denetimidir. Aşağıdaki kaynak kodu bir .ascx dosyasına kaydedin ve bu dosyaya, barındırma Web sayfasının en üstüne yakın olan bu kullanıcı denetimi yönergesinin Register özniteliğine atanan Src dosya adını verin. 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>

Kod örneğinin ikinci bölümü, arabirim ve denetimlerin kaynak kodudur. Kaynak dosya adlı IZipCodebasit bir arabirim içerir. Ayrıca arabirimini uygulayan ve sağlayıcı denetimi olarak davranan adlı ZipCodeWebPart bir WebPart sınıf da vardır. Yöntemi ProvideIZipCode , arabirimin tek üyesini uygulayan geri çağırma yöntemidir. yöntemi yalnızca arabiriminin bir örneğini döndürür. yönteminin meta verilerinde bir ConnectionProvider öznitelikle işaretlendiğini unutmayın. Bu, sağlayıcının bağlantı noktası için geri çağırma yöntemi olarak yöntemini tanımlama mekanizmasıdır. Diğer WebPart sınıf olarak adlandırılır WeatherWebPartve bağlantı için tüketici işlevi görür. Bu sınıf, sağlayıcı denetiminden arabirimin bir örneğini IZipCode alan adlı GetZipCode bir yönteme sahiptir. Bu yöntemin, meta verilerinde bir ConnectionConsumer özniteliği olan tüketicinin bağlantı noktası yöntemi olarak işaretlendiğini unutmayın. Bu, tüketici denetimindeki bağlantı noktası yöntemini tanımlama mekanizmasıdır.

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 kod örneği dinamik derleme kullanı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

Kod örneğinin üçüncü bölümü Web sayfasıdır. Üst kısımda Register , bağlantıyı oluşturan özel denetimleri kaydetme yönergeleri ve kullanıcıların sayfadaki görüntü modlarını değiştirmesine olanak tanıyan kullanıcı denetimi bulunur. Bağlantının kendisi, sayfadaki öğesi içinde <staticconnections> bildirimli olarak oluşturulur. Bu, bağlantı oluşturmanın bir yolunu gösterir; öğesindeki özniteliği not ProviderConnectionPointID<asp:webpartconnection> edin. Bağlantıyı program aracılığıyla da oluşturabilirsiniz; bunu yapmak için kod yöntemindedir Button1_Click . Bu durumda, bir ProviderConnectionPoint nesnesi oluşturulur ve ardından gerçek bağlantıyı oluşturan bir yönteme geçirilir. Bağlantının bildirim temelli veya programlı olarak oluşturulması fark etmeksizin, bağlantı noktalarının her zaman hem sağlayıcı hem de tüketici için belirtilmesi gerekir. Button2_Click yöntemi hem sağlayıcı hem de tüketici için nesnelere erişir ConnectionPoint ve özellik değerlerinden bazılarını sayfadaki bir etikete yazar.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuCS"
    src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

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

  protected void Page_Load(object sender, EventArgs e)
  {
    lblConn.Text = String.Empty;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" >
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1" 
            ProviderConnectionPointID="ZipCodeProvider" 
            ProviderID="zip1" />
        </StaticConnections>      
      </asp:WebPartManager>
      <uc1:displaymodemenucs id="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider"  />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Dynamic Connection" 
        OnClick="Button1_Click" />      
      <br />
      <asp:Button ID="Button2" runat="server" 
        Text="Connection Point Details" 
        OnClick="Button2_Click" />
      <br />
      <asp:Label ID="lblConn" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuVB"
    src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)

    Dim provPoint As ProviderConnectionPoint = _
      mgr.GetProviderConnectionPoints(zip1)("ZipCodeProvider")
    Dim connPoint As ConsumerConnectionPoint = _
      mgr.GetConsumerConnectionPoints(weather1)("ZipCodeConsumer")

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

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

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

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" >
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1" 
            ProviderConnectionPointID="ZipCodeProvider" 
            ProviderID="zip1" />
        </StaticConnections>      
      </asp:WebPartManager>
      <uc1:displaymodemenuvb id="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider"  />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Dynamic Connection" 
        OnClick="Button1_Click" />      
      <br />
      <asp:Button ID="Button2" runat="server" 
        Text="Connection Point Details" 
        OnClick="Button2_Click" />
      <br />
      <asp:Label ID="lblConn" runat="server" />
    </div>
    </form>
</body>
</html>

Sayfayı bir tarayıcıda yükledikten sonra Bağlantı Noktası Ayrıntıları düğmesine tıklayın. Bildirim temelli bağlantıda oluşturulan sağlayıcı ve tüketici bağlantı noktaları hakkında bilgiler görüntülenir. Ardından, sayfayı bağlantı moduna geçmek için Görüntü Modu açılan denetimini kullanın. Posta Kodu TüketiciWebPart denetiminin fiiller menüsünde (başlık çubuğunda aşağı doğru bir okla gösterilir) bağlanma fiiline tıklayın. Bağlantı kullanıcı arabirimi görüntülenir ve sayfada bildirilen denetim tarafından <asp:connectionszone> otomatik olarak oluşturulur. Bu, daha önce ele alınan bildirim temelli ve programlı yöntemlerle birlikte bir bağlantı oluşturmanın başka bir yoludur (kullanıcı arabirimi aracılığıyla). Var olan statik bağlantıyı sonlandırmak için Bağlantıyı Kes düğmesine tıklayın. Sağlayıcı bağlantısı oluştur bağlantısına tıklayın. Kullanıcı arabirimi artık sağlayıcı bağlantı noktası görünen adını listeleyen bir açılan liste denetimi görüntüler. Açılan listeden bağlantı noktasını seçin ve bağlantıyı tamamlamak için Bağlan'a tıklayın. Ardından bağlantıyı kes'e yeniden tıklayın. Ardından, program aracılığıyla bağlantı oluşturmak için Dinamik Bağlantı düğmesine tıklayın. Sayfayı göz atma moduna döndürmek için Görüntü Modu denetimini kullanın. Sağlayıcı bağlantı noktası nesnesiyle ilgili ayrıntıları bir kez daha belirtmek için Bağlantı Noktası Ayrıntıları düğmesine yeniden tıklayın.

Örnekte bağlantı kurma ve sağlayıcı bağlantı noktası kullanma işlemleri üç şekilde gösterilmiştir: Web sayfası işaretlemesinde bildirilen statik bağlantı; bir nesne kullanan kodda oluşturulan bir ProviderConnectionPoint bağlantı ve bağlantı kullanıcı arabirimi aracılığıyla kullanıcı tarafından oluşturulan bir bağlantı.

Açıklamalar

İki sunucu denetimi arasındaki her Web Bölümü bağlantısında, her denetimin (diğer gereksinimlerin yanı sıra) diğer denetime bağlanmasını ve denetimin bağlantı için sağlayıcı veya tüketici olarak belirlenip belirlenmediğine bağlı olarak verileri sağlamasını veya tüketmesini sağlayan ilişkili bir bağlantı noktası nesnesine sahip olması gerekir. Genel ConnectionPoint olarak bir nesne, bir denetimin başka bir denetime nasıl bağlanabileceğine ve paylaşabileceği veri türüne ilişkin ayrıntıları içerir. Bir bağlantıda sağlayıcı olarak davranan bir denetim için, bağlantı noktası bir ProviderConnectionPoint nesne olmalıdır. Web Bölümleri bağlantıları ve bağlantı noktalarıyla ilgili ayrıntılar için aşağıdaki Ayrıca Bkz. bölümünde listelenen konulara bakın.

Nesne oluşturmak ProviderConnectionPoint için birkaç adım gerekir:

1. Bir arabirim oluşturun. Sağlayıcı bir tüketiciyle veri paylaştığında, bunu bir arabirimin örneğini alarak ve bu örneği bir tüketiciye döndürerek yapar.

2. Arabirimi bir sağlayıcıda uygulayın. Sağlayıcı WebPart olacak bir veya başka bir sunucu denetimi (bölgedeki herhangi bir WebPartZoneBase tür sunucu denetimi kullanılabilir) ilk adımda oluşturulan arabirimi uygulamalıdır.

3. Bir geri çağırma yöntemi belirleyin. Sağlayıcıdaki bir yöntem, bağlantı kurmak için geri çağırma yöntemi olarak tanımlanmalıdır. Bu yöntem, uygulanan arabirimin bir örneğini bir tüketiciye döndürür. Sağlayıcıda bir geri çağırma yöntemini tanımlamaya yönelik Web Bölümleri yaklaşımı, arabirim örneğini döndüren yönteme bir ConnectionProvider meta veri özniteliği (sınıf tarafından ConnectionProviderAttribute tanımlanır) eklemektir. Öznitelik eklendiğinde, gerekli tek parametre sağlayıcı bağlantı noktası için kullanılacak bir görünen addır. Bağlantı noktasının kimliği gibi isteğe bağlı parametreler de eklenebilir.

Bir denetim sağlayıcı olarak davranacak şekilde donatıldıktan sonra, denetim bağlantılara katılabilir (bir tüketici denetiminin benzer şekilde donatılmış ve kullanılabilir olduğu varsayılır). Web sayfasının işaretlemesinde statik, bildirim temelli bir bağlantı oluşturmak için geliştiriciler öğesini kullanabilir <asp:webpartconnection> . ConnectionProvider Sağlayıcı kaynak kodunda geri çağırma yöntemini tanımlayan öznitelik bağlantı noktası için bir kimlik belirtiyorsa, bu değerin sayfadaki öğesindeki <asp:webpartconnection> özniteliğine ProviderConnectionPointID atanması gerekir. Bir geliştiricinin sağlayıcı bağlantı noktası için kimlik belirtmesinin bir nedeni, sağlayıcı denetiminde birden çok bağlantı noktası olmasıdır. Sağlayıcı denetimindeki sağlayıcı bağlantı noktası için kimlik belirtilmezse, bağlantı alandan alınan DefaultID varsayılan değer kullanılarak oluşturulacağından, sayfadaki özniteliğe ProviderConnectionPointID bir değer atanması gerekmez.

Kodda bağlantı oluşturmak için geliştiricilerin yöntemini çağırarak GetProviderConnectionPoints ve sağlayıcı denetimindeki tanımlı ProviderConnectionPoint nesnenin kimliği veya diziniyle birlikte sağlayıcı denetiminin kimliğini geçirerek yeni ProviderConnectionPoint bir nesne oluşturması gerekir. Döndürülen ProviderConnectionPoint nesnenin yanı sıra sağlayıcı denetimine bir başvuru, tüketici denetimine bir başvuru ve buna karşılık gelen ConsumerConnectionPoint bir nesne, yeni WebPartConnection bir nesne oluşturmak için yöntemine ConnectWebParts geçirilir.

Geliştiriciler bildirim temelli veya programlı olarak bağlantı kurmanın bir parçası olarak sağlayıcı bağlantı noktalarını kullanasa da, kullanıcılar kullanıcı arabirimi (UI) üzerinden bağlantı kurmak için sağlayıcı bağlantı noktalarıyla da etkileşim kurabilir. Geliştiriciler web sayfasında bir ConnectionsZone denetim bildirirse, kullanıcıların bağlantı oluşturması için bir çalışma zamanı kullanıcı arabirimi sağlar. Kullanıcılar bağlantı fiiline tıklayarak bağlantıyı kurmak için başlangıç noktası olarak tüketici denetimini seçerse (sağlayıcıyı da seçebilirler; sonuçta elde edilen bağlantıda fark yoktur), kullanıcı arabiriminde kullanılabilir sağlayıcı bağlantı noktasının görünen adını (veya birden çok sağlayıcı varsa noktaları) içeren bir açılan liste denetimi görürler. Kullanıcıların bağlantı oluşturmak için bir sağlayıcı bağlantı noktası seçmesi gerekir.

Bir ProviderConnectionPoint nesne doğrudan belirli bir sağlayıcı denetimiyle ilişkilendirir ve temel ConnectionPoint sınıftan devraldığı özelliklerde bir bağlantının ayrıntılarını depolar. Örneğin, devralınan InterfaceType özellikte bir sağlayıcı bağlantı noktası, sağlayıcı tarafından döndürülen arabirim türünü korur. Hem sağlayıcı hem de bir bağlantıdaki tüketici aynı arabirim türüyle çalışırsa, denetimler uyumludur ve doğrudan bağlantı oluşturabilir. Sağlayıcı ve tüketici aynı arabirim türüyle çalışamıyorsa, uyumlu değildir ve sağlayıcı bağlantı noktasının InterfaceType değerini tüketicinin çalışabileceği bir türe çevirmek için bir nesnesi kullanmalıdırWebPartTransformer. Devralınan DisplayName bir diğer önemli özellik, kullanıcıların bağlantı oluştururken bir sağlayıcı bağlantı noktası seçmesi için kullanıcı arabiriminde görüntülenecek kolay bir ad sağlayan özelliğidir. Geliştiriciler bir sağlayıcı denetimindeki geri çağırma yöntemine bir ConnectionProvider öznitelik eklediğinde, görünen ad gerekli parametredir. Devralınan ID özellik, yukarıda belirtildiği gibi, bir sağlayıcının birden çok bağlantı noktası olması durumunda bir sağlayıcı bağlantı noktası için benzersiz bir tanımlayıcı sağladığından da yararlıdır. Sağlayıcıda birden çok ProviderConnectionPoint nesne tanımlanmış olabilir ve bu durumda geliştiriciler özniteliği bir yönteme eklediğinde ConnectionProvider , her bağlantı noktasını ayırt etmek için bir kimlik değeri belirtmelidir. Diğer önemli devralınan özelliklerden biri de, bir sağlayıcı bağlantı noktasının AllowsMultipleConnections birden çok tüketiciye aynı anda bağlanıp bağlanamayacağını gösteren özelliğidir. Bu özellik değeri true varsayılan olarak sağlayıcı bağlantı noktaları içindir (tüketici bağlantı noktaları için varsayılan false değer ise).

sınıfı, ProviderConnectionPoint sınıftan ConnectionPoint devraldığı üyelere birkaç benzersiz yöntem ekler. yöntemi, GetObject geri çağırma yönteminin tüketicilere döndüreceği arabirimin bir örneğini alır. GetSecondaryInterfaces yöntemi, mevcut bir bağlantının parçası olan ancak bağlantıyı kurmak için kullanılan arabirimler olmayan ek tüketici arabirimlerini alır.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

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