Aracılığıyla paylaş

WebPartManager.Connections Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Web sayfasındaki tüm geçerli bağlantıların koleksiyonuna başvuru alır.

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

Özellik Değeri

WebPartConnectionCollection

Bir WebPartConnectionCollection nesne kümesi WebPartConnection içeren.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, denetimin bildirim temelli ve programlı kullanımını WebPartManager gösterir.

Kod örneğinin dört bölümü vardır:

  • Web Bölümleri sayfasındaki görüntü modlarını değiştirmenize olanak tanıyan bir kullanıcı denetimi.

  • Bağlanabilen iki özel WebPart denetim ve bir öğe içeren bir <asp:webpartmanager> Web sayfası.

  • İki özel denetim ve özel WebPart arabirim içeren bir kaynak kod dosyası.

  • Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Aşağıdaki kod, örneğin yalnızca Web sayfası bölümünü içerir. Ayrıca, yukarıda belirtilen özel denetimler için özel kullanıcı denetimine ve kaynak koduna da ihtiyacınız olacaktır. Bu iki öğeyi sınıfa genel bakışın Örnek bölümünden WebPartManager alın.

Aşağıdaki Web sayfası kodu, bir sayfadaki geçerli bağlantıların Connections sayısını almak için program aracılığıyla özelliğinin nasıl kullanılacağını gösterir. Etiket bölümünde, denetimin <script> iki olayını işleme kodunun WebPartManager sayıyı almak için özelliğine eriştiğine Connections dikkat edin.

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

Web sayfasını bir tarayıcıya yükledikten sonra Görüntü Modu açılan liste denetimine tıklayın ve Bağlan'ı seçerek sayfayı bağlantı moduna geçirin. Bağlantı modu, <asp:connectionszone> denetimler arasında bağlantı oluşturmanıza olanak tanımak için öğesini kullanır. Bağlantı modunda, fiil menüsünü etkinleştirmek için POSTA Kodu denetiminin başlık çubuğundaki aşağı oka tıklayın ve ardından Bağlan'a tıklayın. Bağlantı kullanıcı arabirimi (UI) görüntülendikten sonra Tüketici bağlantısı oluştur bağlantısına tıklayın. Açılan liste denetimine sahip bir hücre görüntülenir. Açılan listede Hava Durumu Denetimi'ni seçin ve iki denetimin bağlantısını tamamlamak için Bağlan'a tıklayın. Kapat'a tıklayın ve sayfayı normal gözatma moduna döndürmek için Görüntü Modu açılan listesini kullanın. Bir etiketin artık bağlantı sayısını ve denetim sayısını WebPart görüntülediğini unutmayın. Şimdi bağlantı moduna geri dönüp iki denetimin bağlantısını keserseniz, göz atma moduna döndüğünüzde etiketin içeriği güncelleştirilmeli ve bağlantı olmamalıdır.

Açıklamalar

Connections özelliği, bir sayfadaki geçerli bağlantı kümesine erişmek için bir yol sağlar. Koleksiyonun kendisi salt okunurdur ve koleksiyondan belirli bir bağlantıyı işlemek isteyen geliştiriciler ve DisconnectWebPartsgibi ConnectWebParts yöntemler kullanmalıdırWebPartManager.

Şunlara uygulanır

Ayrıca bkz.