WebPartManagerInternals 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
隔離成不同的類別方法,WebPartManager 控制項會使用這些方法,而且擴充控制項的開發人員會覆寫這些方法,但網頁開發人員很少需要這些方法。
public ref class WebPartManagerInternals sealed
public sealed class WebPartManagerInternals
type WebPartManagerInternals = class
Public NotInheritable Class WebPartManagerInternals
- 繼承
-
WebPartManagerInternals
備註
類別 WebPartManager 是 Web 元件控制件集中的最大類別。 它也是最重要的網頁元件類別之一,因為它用於包含網頁元件控件的每個網頁,而且會協調和管理頁面上的所有網頁元件控件。
因為類別 WebPartManager 經常使用,而且它包含許多公開的方法,所以擴充控件的開發人員大多需要一些方法,而擴充 WebPartManager 控件的開發人員大多會包含在類別中 WebPartManagerInternals 。 將較少使用的方法隔離至 WebPartManagerInternals 類別可簡化 類別的 WebPartManager API,而隔離的方法不會出現在 IntelliSense 中的 物件上 WebPartManager 。
使用類別的 WebPartManagerInternals 開發人員可能會有需要繼承自 控件並 WebPartManager 廣泛自定義的案例。 例如,如果您要建置 Web 入口網站應用程式或一組封裝的 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) 。