WebPartManager.Connections Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Hiermee haalt u een verwijzing op naar de verzameling van alle huidige verbindingen op een webpagina.

public:
 property System::Web::UI::WebControls::WebParts::WebPartConnectionCollection ^ Connections { System::Web::UI::WebControls::WebParts::WebPartConnectionCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartConnectionCollection Connections { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Connections : System.Web.UI.WebControls.WebParts.WebPartConnectionCollection
Public ReadOnly Property Connections As WebPartConnectionCollection

Waarde van eigenschap

WebPartConnectionCollection

Een WebPartConnectionCollection met een set WebPartConnection objecten.

Kenmerken
BrowsableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u het declaratieve en programmatische gebruik van het WebPartManager besturingselement.

Het codevoorbeeld heeft vier delen:

  • Een gebruikersbeheer waarmee u weergavemodi op een pagina met webonderdelen kunt wijzigen.

  • Een webpagina met twee aangepaste WebPart besturingselementen die kunnen worden verbonden en een <asp:webpartmanager> element.

  • Een broncodebestand met twee aangepaste WebPart besturingselementen en een aangepaste interface.

  • Een uitleg van hoe het voorbeeld werkt in een browser.

De volgende code bevat alleen het webpaginagedeelte van het voorbeeld. U hebt ook het aangepaste gebruikersbesturingselement en de broncode nodig voor de hierboven genoemde aangepaste besturingselementen. Haal deze twee items op uit de sectie Voorbeeld van het WebPartManager klassenoverzicht.

De volgende webpaginacode laat zien hoe u de Connections eigenschap programmatisch gebruikt om het aantal huidige verbindingen op een pagina op te halen. Houd er rekening mee dat in de <script> tagsectie de code voor het afhandelen van twee gebeurtenissen voor het WebPartManager besturingselement toegang heeft tot de Connections eigenschap om het aantal te verkrijgen.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  private void UpdateLabelData(int wpCount, int connCount)
  {
    Label1.Text = "WebPart Control Count:  " + wpCount.ToString();
    Label2.Text = "Connections Count: " + connCount.ToString();
  }

  protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

  protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
        OnWebPartsConnected="WebPartManager1_WebPartsConnected" 
        OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" 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" 
  Assembly="ConnectionSampleVB" %>

<!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 WebPartManager1_WebPartsConnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub

  Protected Sub WebPartManager1_WebPartsDisconnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub
  
  Private Sub UpdateLabelData(ByVal wpCount As Integer, _
    ByVal connCount As Integer)
    
    Label1.Text = "WebPart Control Count:  " & wpCount.ToString()
    Label2.Text = "Connections Count: " & connCount.ToString()
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

Nadat u de webpagina in een browser hebt geladen, klikt u op het besturingselement voor de vervolgkeuzelijst Weergavemodus en selecteert u Verbinding maken om de pagina over te schakelen naar de verbindingsmodus. De verbindingsmodus maakt gebruik van het <asp:connectionszone> element om verbindingen tussen besturingselementen te maken. Klik in de verbindingsmodus op de pijl-omlaag in de titelbalk van het besturingselement Postcode om het menu werkwoorden te activeren en klik vervolgens op Verbinden. Nadat de gebruikersinterface (UI) voor de verbinding wordt weergegeven, klikt u op de koppeling Een verbinding met een consument maken . Er wordt een cel weergegeven met een besturingselement voor de vervolgkeuzelijst. Selecteer Weerbesturingselement in de vervolgkeuzelijst en klik op Verbinding maken om de verbinding van de twee besturingselementen te voltooien. Klik op Sluiten en gebruik vervolgens de vervolgkeuzelijst Weergavemodus om de pagina terug te zetten naar de normale bladermodus. Een label geeft nu het aantal verbindingen en het aantal WebPart besturingselementen weer. Als u nu terugkeert naar de verbindingsmodus en de verbinding met de twee besturingselementen verbreekt, moet de inhoud van het label worden bijgewerkt en moeten er geen verbindingen zijn.

Opmerkingen

De Connections eigenschap biedt een manier om toegang te krijgen tot de huidige set verbindingen op een pagina. De verzameling zelf heeft het kenmerk Alleen-lezen en ontwikkelaars die een specifieke verbinding van de verzameling willen bewerken, moeten WebPartManager methoden zoals ConnectWebParts en DisconnectWebParts.

Van toepassing op

Zie ook