ProxyWebPartManager.StaticConnections ProxyWebPartManager.StaticConnections ProxyWebPartManager.StaticConnections ProxyWebPartManager.StaticConnections Property

Определение

Получает коллекцию статических связей, объявленных в элементе <asp:proxywebpartmanager> на странице содержимого.Gets a collection of static connections declared within the <asp:proxywebpartmanager> element on a content page.

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; }
member this.StaticConnections : System.Web.UI.WebControls.WebParts.ProxyWebPartConnectionCollection
Public ReadOnly Property StaticConnections As ProxyWebPartConnectionCollection

Значение свойства

Объект ProxyWebPartConnectionCollection, содержащий все статические объекты WebPartConnection, объявленные в элементе <asp:proxywebpartmanager>.A ProxyWebPartConnectionCollection that contains all static WebPartConnection objects declared within an <asp:proxywebpartmanager> element.

Примеры

В следующем примере кода показано, StaticConnections как использовать свойство ProxyWebPartManager класса.The following code example demonstrates how to use the StaticConnections property on the ProxyWebPartManager class. В этом примере кода показана только соответствующая часть кода со страницы содержимого, которая объявляет ProxyWebPartManager элемент управления и статическое соединение.This code example shows only the relevant portion of the code from the content page that declares the ProxyWebPartManager control and the static connection. Другие страницы, необходимые для выполнения примера кода, и описание их настройки см. в разделе "пример" ProxyWebPartManager раздела Общие сведения о классе.For the other pages required to run the code example, and a description of how to set them up, see the Example section of the ProxyWebPartManager class overview.

Следующий код представляет собой страницу содержимого, которая объявляет <staticconnections> элемент как дочерний <asp:proxywebpartmanager> элемент.The following code is the content page that declares the <staticconnections> element as a child of the <asp:proxywebpartmanager> element. Также обратите внимание Button1_Click , что метод проверяет количество StaticConnections свойства ProxyWebPartManager элемента управления и записывает его на страницу.Also note that the Button1_Click method checks the count of the StaticConnections property on the ProxyWebPartManager control and writes it to the page.

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

После загрузки страницы в браузере нажмите кнопку сведения о WebPartManager и просмотрите сведения об WebPartManager элементе управления на главной ProxyWebPartManager странице и элементе управления на странице содержимое.After you load the page in a browser, click the WebPartManager Information button and observe the information about the WebPartManager control in the master page, and the ProxyWebPartManager control in the content page. Например, обратите внимание, что они имеют одинаковое количество в соответствующих свойствах, которые отправляют статические соединения ( StaticConnections свойство).For example, note that they both have the same count in their respective properties that track static connections (the StaticConnections property).

Комментарии

Свойство ссылается на WebPartConnection коллекцию объектов, объявленных в <asp:proxywebpartmanager> элементе. StaticConnectionsThe StaticConnections property references the collection of WebPartConnection objects declared in an <asp:proxywebpartmanager> element. Соединения, содержащиеся в этой коллекции, добавляются к статическим соединениям WebPartManager элементов управления (на которые ссылается его WebPartManager.StaticConnections коллекция) и обрабатываются точно так же, WebPartManager как и любые другие соединения, связанные с элементом управления.The connections contained in this collection are added to the static connections of the WebPartManager controls (referenced by its WebPartManager.StaticConnections collection), and treated exactly like any other connections associated with the WebPartManager control.

Декларативный элемент, соответствующий StaticConnections свойству, <staticconnections> является элементом.The declarative element that corresponds to the StaticConnections property is the <staticconnections> element. В <staticconnections> приложении, использующем главные страницы, элемент добавляется в качестве дочернего <asp:proxywebpartmanager> элемента на странице <asp:webpartconnection> содержимого, а элемент, в <staticconnections> свою очередь, добавляется в качестве дочернего элемента для элемента.In an application that uses master pages, the <staticconnections> element is added as a child of the <asp:proxywebpartmanager> element on a content page, and an <asp:webpartconnection> element in turn is added as a child of the <staticconnections> element. К <asp:webpartconnection> одному<staticconnections> элементу можно добавить несколько элементов, и несколько страниц содержимого могут объявлять статические соединения как часть приложения главной страницы.Multiple <asp:webpartconnection> elements can be added to one <staticconnections> element, and multiple content pages can declare static connections as part of a master pages application.

Применяется к

Дополнительно