WebPartConnectionsEventArgs 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

提供 WebPartsConnected 控制項的 WebPartsDisconnected 和 WebPartManager 事件的事件資料。

public ref class WebPartConnectionsEventArgs : EventArgs
public class WebPartConnectionsEventArgs : EventArgs
type WebPartConnectionsEventArgs = class
    inherit EventArgs
Public Class WebPartConnectionsEventArgs
Inherits EventArgs
繼承
Object
EventArgs
WebPartConnectionsEventArgs

備註

使用 Web 元件控制項集的功能，可以在兩 WebPart 個或其他伺服器控制項之間建立連接，其中一個控制項做為提供者，另一個控制項做為資料的取用者。 若要形成連接，這兩個控制項必須位於繼承自 WebPartZoneBase 類別 (的區域，例如 WebPartZone 控制項) ，而且必須正確設計它們，才能透過通用介面共用資料。 如需網頁元件連線的詳細資訊，請參閱 WebPartConnection 和 Web 元件連線概觀。

類別會將 WebPartConnectionsEventArgs 事件資料傳遞至使用 WebPartConnectionsEventHandler 委派來處理事件的方法。 有兩種這類連接相關方法會引發事件，並使用 WebPartConnectionsEventArgs 類別來提供事件資料。 兩者都是 控制項的成員 WebPartManager 。 方法 OnWebPartsConnected 會在兩個伺服器控制項成功連接之後引發 WebPartsConnected 事件，而 OnWebPartsDisconnected 方法會在兩個伺服器控制項中斷連接之後引發 WebPartsDisconnected 事件。

開發人員可以建立 WebPartsConnected 和 WebPartsDisconnected 事件的自訂事件處理常式方法，在這些方法中，他們可以使用 WebPartConnectionsEventArgs 類別來存取連線的詳細資料。 例如，開發人員可以在 元素上 <asp:webpartmanager> 宣告 OnWebPartsConnected 屬性，並將其指派為將處理事件的自訂方法名稱。 在自訂處理常式方法中，開發人員可以使用傳遞至方法做為參數的物件來存取連接 WebPartConnectionsEventArgs 的詳細資料。

類別 WebPartConnectionsEventArgs 有兩個建構函式的多載。 建 WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) 構函式是預設值，它會初始化 類別的屬性值。 建 WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) 構函式會呼叫無參數建構函式，然後也會初始化 Connection 屬性。

類別 WebPartConnectionsEventArgs 有數個屬性，全部都參考網頁元件連線的基本層面。 屬性 Connection 是指代表整個連接的相關聯 WebPartConnection 物件。 屬性 Provider 會參考 WebPart 做為連接中提供者的 或其他伺服器控制項，而 Consumer 屬性則參考 WebPart 做為取用者的 或 伺服器控制項。 屬性 ProviderConnectionPoint 會參考連接 ProviderConnectionPoint 的物件，而 屬性則 ConsumerConnectionPoint 參考 ConsumerConnectionPoint 物件。

建構函式

WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

初始化 WebPartConnectionsEventArgs 類別的新執行個體，而不需要 WebPartConnection 物件。
WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection)

使用指定的 WebPartConnection 物件，初始化類別的新執行個體。

屬性

Connection

取得目前連接的 WebPartConnection 物件。
Consumer

取得做為連接之消費者的 WebPart 控制項。
ConsumerConnectionPoint

取得目前連接的 ConsumerConnectionPoint 物件。
Provider

取得做為連接之提供者的 WebPart 控制項。
ProviderConnectionPoint

取得目前連接的 ProviderConnectionPoint 物件。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱