Freigeben über

WebPartManager.Connections Eigenschaft

Definition

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

Ruft einen Verweis auf die Auflistung aller aktuellen Verbindungen auf einer Webseite ab.

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

Eigenschaftswert

WebPartConnectionCollection

A WebPartConnectionCollection that contains a set of WebPartConnection objects.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die deklarative und programmgesteuerte Verwendung des WebPartManager Steuerelements veranschaulicht.

Das Codebeispiel enthält vier Teile:

  • Ein Benutzersteuerelement, mit dem Sie Anzeigemodi auf einer Webparts-Seite ändern können.

  • Eine Webseite mit zwei benutzerdefinierten WebPart Steuerelementen, die verbunden werden können, und ein <asp:webpartmanager> Element.

  • Eine Quellcodedatei, die zwei benutzerdefinierte Steuerelemente und eine benutzerdefinierte WebPart Schnittstelle enthält.

  • Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Der folgende Code enthält nur den Webseitenteil des Beispiels. Außerdem benötigen Sie das benutzerdefinierte Benutzersteuerelement und den Quellcode für die oben genannten benutzerdefinierten Steuerelemente. Rufen Sie diese beiden Elemente aus dem Beispielabschnitt der WebPartManager Klassenübersicht ab.

Der folgende Webseitencode veranschaulicht, wie die Connections Eigenschaft programmgesteuert verwendet wird, um die Anzahl der aktuellen Verbindungen auf einer Seite abzurufen. Beachten Sie, dass im <script> Tagabschnitt der Code zum Behandeln von zwei Ereignissen für das WebPartManager Steuerelement auf die Connections Eigenschaft zugreift, um die Anzahl abzurufen.

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

Nachdem Sie die Webseite in einem Browser geladen haben, klicken Sie auf das Dropdownlistensteuerelement "Anzeigemodus ", und wählen Sie "Verbinden" aus, um die Seite in den Verbindungsmodus zu wechseln. Der Verbindungsmodus verwendet das <asp:connectionszone> Element, damit Sie Verbindungen zwischen Steuerelementen erstellen können. Klicken Sie im Verbindungsmodus auf den Abwärtspfeil in der Titelleiste des PLZ-Steuerelements , um das Verbenmenü zu aktivieren, und klicken Sie dann auf "Verbinden". Klicken Sie nach dem Anzeigen der Verbindungs-Benutzeroberfläche auf die Verbindung mit einem Consumer-Link . Eine Zelle wird angezeigt, die über ein Dropdownlistensteuerelement verfügt. Wählen Sie " Wettersteuerelement " in der Dropdownliste aus, und klicken Sie auf "Verbinden" , um die Verbindung der beiden Steuerelemente abzuschließen. Klicken Sie auf "Schließen", und verwenden Sie dann die Dropdownliste " Anzeigemodus ", um die Seite in den normalen Suchmodus zurückzugeben. Beachten Sie, dass eine Beschriftung jetzt die Anzahl der Verbindungen und die Anzahl der WebPart Steuerelemente anzeigt. Wenn Sie nun zum Verbindungsmodus zurückkehren und die beiden Steuerelemente trennen, sollte der Inhalt der Bezeichnung aktualisiert werden, und es sollten keine Verbindungen vorhanden sein.

Hinweise

Die Connections Eigenschaft bietet eine Möglichkeit, auf die aktuelle Gruppe von Verbindungen auf einer Seite zuzugreifen. Die Sammlung selbst ist schreibgeschützt, und Entwickler, die eine bestimmte Verbindung aus der Auflistung bearbeiten möchten, sollten WebPartManager Methoden wie ConnectWebParts und DisconnectWebParts.

Gilt für:

Weitere Informationen