ProxyWebPartManager.StaticConnections Eigenschap

Definitie

Hiermee haalt u een verzameling statische verbindingen op die zijn gedeclareerd binnen het <asp:proxywebpartmanager> element op een inhoudspagina.

public:
 property System::Web::UI::WebControls::WebParts::ProxyWebPartConnectionCollection ^ StaticConnections { System::Web::UI::WebControls::WebParts::ProxyWebPartConnectionCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.WebParts.ProxyWebPartConnectionCollection StaticConnections { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.StaticConnections : System.Web.UI.WebControls.WebParts.ProxyWebPartConnectionCollection
Public ReadOnly Property StaticConnections As ProxyWebPartConnectionCollection

Waarde van eigenschap

Een ProxyWebPartConnectionCollection met alle statische WebPartConnection objecten die zijn gedeclareerd binnen een <asp:proxywebpartmanager> element.

Kenmerken

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de StaticConnections eigenschap in de ProxyWebPartManager klasse gebruikt. In dit codevoorbeeld ziet u alleen het relevante gedeelte van de code van de inhoudspagina dat het ProxyWebPartManager besturingselement en de statische verbinding declareert. Zie de sectie Voorbeeld van het ProxyWebPartManager klassenoverzicht voor de andere pagina's die nodig zijn om het codevoorbeeld uit te voeren en een beschrijving van hoe u deze kunt instellen.

De volgende code is de inhoudspagina die het <staticconnections> element declareert als een onderliggend element.<asp:proxywebpartmanager> Houd er ook rekening mee dat de Button1_Click methode het aantal StaticConnections eigenschappen op het ProxyWebPartManager besturingselement controleert en naar de pagina schrijft.

<%@ Page Language="C#" MasterPageFile="~/MasterPageCS.master" 
  Title="Connections Page" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    StringBuilder lblText = new StringBuilder();
    
    if (Page.Master.FindControl("WebPartManager1") != null)
    {
      WebPartManager theMgr = 
        (WebPartManager)Page.Master.FindControl("WebPartManager1");
      lblText.Append("WebPartManager:  <br /><pre>" +
        "  Master page file is " + Page.MasterPageFile + "<br />" +
        "  ID is " + theMgr.ID + "<br />" +
        "  Connection count is " +
           theMgr.StaticConnections.Count.ToString() + "<br />" +
        "  WebParts count is " +
           theMgr.WebParts.Count.ToString() + "</pre><br />");
    }

    if (proxymgr1 != null)
    {
      lblText.Append("ProxyWebPartManager:  <br /><pre>" +
        "  Content page file is " + Request.Path + "<br />" +
        "  ID is " + proxymgr1.ID + "<br />" +
        "  Connection count is " +
           proxymgr1.StaticConnections.Count.ToString() + 
           "</pre><br />");
    }

    Literal1.Text = lblText.ToString();
    
  }
  
</script>

<asp:Content ID="Content1" Runat="Server" 
  ContentPlaceHolderID="ContentPlaceHolder1" >
 
  <asp:proxywebpartmanager id="proxymgr1" runat="server">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>    
  </asp:proxywebpartmanager>

  <div>
  <asp:webpartzone id="zone1" 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>
  </div>
  
  <div>
  <asp:button id="Button1" runat="server" 
    text="WebPartManager Information" onclick="Button1_Click" />
  <br />
  
  </div>
  
  <asp:connectionszone id="ConnectionsZone1" runat="server" />
  <asp:literal id="Literal1" runat="server" />

</asp:Content>
<%@ Page Language="VB" MasterPageFile="~/MasterPageVB.master" 
  Title="Connections Page" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

<script runat="server">

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

    Dim lblText As StringBuilder = New StringBuilder()

    If Not (Page.Master.FindControl("WebPartManager1") Is Nothing) Then
      Dim theMgr As WebPartManager = _
        CType(Page.Master.FindControl("WebPartManager1"), WebPartManager)
      lblText.Append("WebPartManager:  <br /><pre>" & _
        "  Master page file is " & Page.MasterPageFile & "<br />" & _
        "  ID is " & theMgr.ID & "<br />" & _
        "  Connection count is " & _
           theMgr.StaticConnections.Count.ToString() & "<br />" & _
        "  WebParts count is " & _
           theMgr.WebParts.Count.ToString() & "</pre><br />")
    End If

    If Not (proxymgr1 Is Nothing) Then
      lblText.Append("ProxyWebPartManager:  <br /><pre>" & _
        "  Content page file is " & Request.Path & "<br />" & _
        "  ID is " & proxymgr1.ID & "<br />" & _
        "  Connection count is " & _
           proxymgr1.StaticConnections.Count.ToString() & "</pre><br />")
    End If

    Literal1.Text = lblText.ToString()
    
  End Sub

</script>

<asp:Content ID="Content1" Runat="Server" 
  ContentPlaceHolderID="ContentPlaceHolder1" >

  <asp:proxywebpartmanager id="proxymgr1" runat="server">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>    
  </asp:proxywebpartmanager>

  <div>
  <asp:webpartzone id="zone1" 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>
  </div>
  
  <div>
  <asp:button id="Button1" runat="server" 
    text="WebPartManager Information" onclick="Button1_Click" />
  <br />
  <asp:literal id="Literal1" runat="server" />
  </div>
  
  <asp:connectionszone id="ConnectionsZone1" runat="server" />
  
</asp:Content>

Nadat u de pagina in een browser hebt geladen, klikt u op de knop WebPartManager-informatie en bekijkt u de informatie over het WebPartManager besturingselement op de basispagina en het ProxyWebPartManager besturingselement op de inhoudspagina. Houd er bijvoorbeeld rekening mee dat ze beide hetzelfde aantal hebben in hun respectieve eigenschappen waarmee statische verbindingen (de StaticConnections eigenschap) worden bijgehouden.

Opmerkingen

De StaticConnections eigenschap verwijst naar de verzameling WebPartConnection objecten die in een <asp:proxywebpartmanager> element zijn gedeclareerd. De verbindingen in deze verzameling worden toegevoegd aan de statische verbindingen van de besturingselementen (waarnaar wordt verwezen door WebPartManager de WebPartManager.StaticConnections verzameling) en worden precies behandeld als alle andere verbindingen die aan het WebPartManager besturingselement zijn gekoppeld.

Het declaratieve element dat overeenkomt met de StaticConnections eigenschap is het <staticconnections> element. In een toepassing die gebruikmaakt van basispagina's, wordt het <staticconnections> element toegevoegd als een onderliggend element op <asp:proxywebpartmanager> een inhoudspagina en wordt een <asp:webpartconnection> element op zijn beurt toegevoegd als onderliggend element van het <staticconnections> element. Er kunnen meerdere <asp:webpartconnection> elementen worden toegevoegd aan één <staticconnections> element en meerdere inhoudspagina's kunnen statische verbindingen declareren als onderdeel van een basispaginatoepassing.

Van toepassing op

Zie ook