WebPartManager.Connections Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

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.

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

Eine WebPartConnectionCollection, die einen Satz von WebPartConnection-Objekten enthält.

Attribute: BrowsableAttribute

Beispiele

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

Das Codebeispiel weist vier Teile auf:

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 mit zwei benutzerdefinierten Steuerelementen und einer benutzerdefinierten WebPart Schnittstelle.
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 die benutzerdefinierte Benutzersteuerung 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, der zwei Ereignisse für das WebPartManager Steuerelement behandelt, 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 für den Anzeigemodus, und wählen Sie Verbinden aus, um die Seite zum Verbindungsmodus zu wechseln. Verbinden Modus 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 POSTLEITZAHL-Steuerelements, um das Menü "Verben" zu aktivieren, und klicken Sie dann auf Verbinden. Klicken Sie nach der Anzeige der Benutzeroberfläche (Connection User Interface) auf die Verbindung mit einem Consumer-Link . Eine Zelle wird angezeigt, die über ein Dropdownlistensteuerelement verfügt. Wählen Sie "Wettersteuerung" 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 Browsemodus zurückzugeben. Beachten Sie, dass eine Bezeichnung 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