ProxyWebPartManager.StaticConnections Eigenschaft

Definition

Lässt innerhalb des <asp:proxywebpartmanager>-Elements auf einer Inhaltsseite eine Auflistung statischer Verbindungen deklarieren.

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

Eigenschaftswert

ProxyWebPartConnectionCollection

Eine ProxyWebPartConnectionCollection, die alle statischen innerhalb eines <asp:proxywebpartmanager>-Elements deklarierten WebPartConnection-Objekte enthält.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die StaticConnections Eigenschaft in der ProxyWebPartManager Klasse verwendet wird. In diesem Codebeispiel wird nur der relevante Teil des Codes aus der Inhaltsseite angezeigt, der das Steuerelement und die ProxyWebPartManager statische Verbindung deklariert. Für die anderen Seiten, die zum Ausführen des Codebeispiels erforderlich sind, und eine Beschreibung der Einrichtung finden Sie im Abschnitt "Beispiel" der ProxyWebPartManager Klassenübersicht.

Der folgende Code ist die Inhaltsseite, die das <staticconnections> Element als untergeordnetes Element des <asp:proxywebpartmanager> Elements deklariert. Beachten Sie auch, dass die Button1_Click Methode die Anzahl der StaticConnections Eigenschaft auf dem ProxyWebPartManager Steuerelement überprüft und auf die Seite schreibt.

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

Nachdem Sie die Seite in einem Browser geladen haben, klicken Sie auf die Schaltfläche "WebPartManager-Informationen ", und beobachten Sie die Informationen zum WebPartManager Steuerelement auf der Gestaltungsvorlage und das ProxyWebPartManager Steuerelement auf der Inhaltsseite. Beachten Sie beispielsweise, dass beide die gleiche Anzahl in ihren jeweiligen Eigenschaften haben, die statische Verbindungen (die StaticConnections Eigenschaft) nachverfolgen.

Hinweise

Die StaticConnections Eigenschaft verweist auf die Auflistung von WebPartConnection Objekten, die in einem <asp:proxywebpartmanager> Element deklariert sind. Die in dieser Auflistung enthaltenen Verbindungen werden den statischen Verbindungen der WebPartManager Steuerelemente hinzugefügt ( WebPartManager.StaticConnections auf deren Auflistung verwiesen) und genau wie alle anderen Verbindungen behandelt, die dem WebPartManager Steuerelement zugeordnet sind.

Das deklarative Element, das der Eigenschaft entspricht, ist das StaticConnections <staticconnections> Element. In einer Anwendung, die Gestaltungsvorlagen verwendet, wird das <staticconnections> Element als untergeordnetes Element auf einer Inhaltsseite hinzugefügt, und ein <asp:webpartconnection> Element wird wiederum als <asp:proxywebpartmanager> untergeordnetes Element des <staticconnections> Elements hinzugefügt. Mehrere Elemente können einem <staticconnections> Element hinzugefügt werden, und mehrere <asp:webpartconnection> Inhaltsseiten können statische Verbindungen als Teil einer Gestaltungsvorlagenanwendung deklarieren.

Gilt für

Siehe auch