ProxyWebPartManager.StaticConnections Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.ProxyWebPartConnectionCollectionPublic ReadOnly Property StaticConnections As ProxyWebPartConnectionCollectionEigenschaftswert
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.