WebPartManager.BeginWebPartConnecting(WebPart) 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

啟動連接兩個 WebPart 控制項的程序。

public:
 virtual void BeginWebPartConnecting(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

public virtual void BeginWebPartConnecting (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit

Public Overridable Sub BeginWebPartConnecting (webPart As WebPart)

參數

webPart

WebPart

正在建立連接的控制項。

例外狀況

ArgumentNullException

webPart 為 null。

InvalidOperationException

頁面上目前的顯示模式不是 ConnectDisplayMode。

ArgumentException

webPart 已關閉。

-或-

webPart 不是 Controls 集合的一部分。

-或-

webPart 等於 SelectedWebPart 控制項。

備註

方法 BeginWebPartConnecting 存在，讓控制項之間的連線形成程式可以在不同的階段完成，讓開發人員更充分地控制連線程式。 方法會執行一組初始檢查， webPart 以確保處於可合法形成連線的狀態。 如果 webPart 通過所有檢查，則會將其設定為目前選取的控制項， (查看 SelectedWebPart 屬性) ，而且連線程式可以繼續。

給繼承者的注意事項

需要擴充控制項的 WebPartManager 開發人員可能會想要覆寫衍生類別中的這個方法。 其中一種方法是呼叫基底方法，然後新增一些額外的自訂處理;或者，您可能想要完全自訂在控制項之間啟動連線的程式。 例如，您可能想要先確認特定資料可在建立連線之前使用。

另請參閱

• EndWebPartConnecting()