WebPartConnectionsEventArgs 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供 WebPartsConnected 控制項的 WebPartsDisconnected 和 WebPartManager 事件的事件資料。
public ref class WebPartConnectionsEventArgs : EventArgs
public class WebPartConnectionsEventArgs : EventArgs
type WebPartConnectionsEventArgs = class
inherit EventArgs
Public Class WebPartConnectionsEventArgs
Inherits EventArgs
- 繼承
備註
使用 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 物件。
建構函式
屬性
Connection |
取得目前連接的 WebPartConnection 物件。 |
Consumer |
取得做為連接之消費者的 WebPart 控制項。 |
ConsumerConnectionPoint |
取得目前連接的 ConsumerConnectionPoint 物件。 |
Provider |
取得做為連接之提供者的 WebPart 控制項。 |
ProviderConnectionPoint |
取得目前連接的 ProviderConnectionPoint 物件。 |
方法
Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應