WebPartManagerInternals 類別

  • 參考

定義

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

隔離成不同的類別方法，WebPartManager 控制項會使用這些方法，而且擴充控制項的開發人員會覆寫這些方法，但網頁開發人員很少需要這些方法。

public ref class WebPartManagerInternals sealed
public sealed class WebPartManagerInternals
type WebPartManagerInternals = class
Public NotInheritable Class WebPartManagerInternals
繼承
Object
WebPartManagerInternals

備註

類別 WebPartManager 是 Web 元件控制項集中的最大類別。 這也是最重要的網頁元件類別之一，因為它用於包含網頁元件控制項的每個網頁，而且會協調和管理頁面上的所有網頁元件控制項。

因為類別 WebPartManager 經常使用，而且它包含這麼多公開的方法，所以擴充控制項的開發人員 WebPartManager 大部分需要的方法都包含在 類別中 WebPartManagerInternals 。 這種較不使用的方法隔離至 WebPartManagerInternals 類別可簡化 類別的 WebPartManager API，而隔離的方法不會出現在 IntelliSense 中的 物件上 WebPartManager 。

使用 類別 WebPartManagerInternals 的開發人員可能會有需要繼承自 WebPartManager 控制項並廣泛自訂的案例。 例如，如果您要建置 Web 入口網站應用程式或一組封裝的網頁元件控制項，其中包含自訂顯示模式、自訂區域、自訂動詞、自訂 WebPart 控制項，以及基底 Web 元件使用者介面的其他延伸模組， (UI) ，在許多情況下，您不需要覆寫和擴充部分 WebPartManager 成員 (並非全部) 。 雖然類別是密封的 WebPartManagerInternals ，因此您無法繼承它，但自訂 WebPartManager 類別可能需要呼叫一些方法，才能管理頁面上的 WebPartManagerInternals 網頁元件控制項。

注意

WebPartManager和 類別一樣，類別 WebPartManagerInternals 會提供沒有 UI 且永遠不會顯示在頁面上的伺服器控制項。 不同于 WebPartManager ，類別 WebPartManagerInternals 永遠不會在頁面的標記中宣告;它絕對是執行背景工作的背景工作物件。 使用它的一般方式是由 WebPartManager 類別示範，其會透過受保護的 Internals 屬性來參考它，並使用參考的物件來呼叫 WebPartManagerInternals 方法。

類別 WebPartManagerInternals 只包含方法;沒有屬性或事件。 類別中的所有方法都牽涉到管理 WebPart 控制項，或控制項之間的連線。

若要處理 WebPart 控制項， WebPartManagerInternals 包括新增控制項的方法 (AddWebPart) 、移除它們 RemoveWebPart) 、處理事件 CallOnDeleting) 、取得或設定其 (區域關聯性的詳細資料，例如 GetZoneID 和 SetZoneIndex) ，或設定 (的基本 WebPart 控制項屬性， SetIsClosed 以及 SetHasSharedData) 。

若要處理連線， WebPartManagerInternals 包括 () DeleteConnection 刪除它們的方法、將要使用的轉換程式物件設定為 (SetTransformer) 、設定連線是否為靜態 (SetIsShared(WebPartConnection, Boolean) 和 SetIsStatic(WebPartConnection, Boolean)) ，以及將連線錯誤訊息設定為使用 (SetConnectErrorMessage) 。

方法

AddWebPart(WebPart)

將 WebPart 或伺服器控制項加入至網頁上 WebPartManager 控制項的 WebPart 控制項集合。
CallOnClosing(WebPart)

呼叫指定控制項的 OnClosing(EventArgs) 方法。
CallOnConnectModeChanged(WebPart)

呼叫指定控制項的 OnConnectModeChanged(EventArgs) 方法。
CallOnDeleting(WebPart)

呼叫指定控制項的 OnDeleting(EventArgs) 方法。
CallOnEditModeChanged(WebPart)

呼叫指定控制項的 OnEditModeChanged(EventArgs) 方法。
ConnectionDeleted(WebPartConnection)

指出是否已刪除指定的 WebPartConnection 物件。
CreateObjectFromType(Type)

根據傳遞給方法的參數建立物件。
DeleteConnection(WebPartConnection)

設定屬性，表示已刪除指定的連接物件。
Equals(Object)

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

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
GetZoneID(WebPart)

取得包含指定的 WebPart 或伺服器控制項的區域 ID。
LoadConfigurationState(WebPartTransformer, Object)

為參與控制項之間連接的 WebPartTransformer 物件，載入先前儲存的狀態資料。
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
RemoveWebPart(WebPart)

從 WebPart 控制項的控制項集合移除 WebPartManager 或其他伺服器控制項。
SaveConfigurationState(WebPartTransformer)

儲存參與控制項之間連接的 WebPartTransformer 物件之狀態資料。
SetConnectErrorMessage(WebPart, String)

建立錯誤訊息，並且讓負責呈現 WebPartChrome 控制項的 WebPart 物件呈現該訊息，而不是控制項的內容。
SetHasSharedData(WebPart, Boolean)

在 WebPart 或其他伺服器控制項上設定屬性，指出控制項是否具有共用個人化資料。
SetHasUserData(WebPart, Boolean)

在 WebPart 或其他伺服器控制項上設定屬性，指出控制項是否具有使用者個人化資料。
SetIsClosed(WebPart, Boolean)

設定 IsClosed 控制項的 WebPart 屬性。
SetIsShared(WebPart, Boolean)

設定 IsShared 控制項的 WebPart 屬性。
SetIsShared(WebPartConnection, Boolean)

設定 IsShared 物件的 WebPartConnection 屬性。
SetIsStandalone(WebPart, Boolean)

設定 IsStandalone 控制項的 WebPart 屬性。
SetIsStatic(WebPart, Boolean)

設定 IsStatic 控制項的 WebPart 屬性。
SetIsStatic(WebPartConnection, Boolean)

設定 IsStatic 物件的 WebPartConnection 屬性。
SetTransformer(WebPartConnection, WebPartTransformer)

指派要在兩個伺服器控制項之間的連接中使用的 WebPartTransformer 物件。
SetZoneID(WebPart, String)

設定屬性，讓 WebPart 或伺服器控制項保留包含區域的 ID。
SetZoneIndex(WebPart, Int32)

在指定的控制項的區域 (與該區域內其他 WebPart 控制項相關聯) 內設定指定控制項的索引。
ToString()

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

(繼承來源 Object)

適用於

另請參閱