NestedContainer 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

來源:

NestedContainer.cs

提供 INestedContainer 介面的簡單實作，讓容器有主控元件。

public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::IContainer, System::ComponentModel::INestedContainer

public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.IContainer, System.ComponentModel.INestedContainer

type NestedContainer = class
    inherit Container
    interface IContainer
    interface IDisposable
    interface INestedContainer

Public Class NestedContainer
Inherits Container
Implements IContainer, IDisposable, INestedContainer

繼承

Object

Container

NestedContainer

實作

IContainer INestedContainer IDisposable

備註

類別 NestedContainer 是 介面的簡單實作 INestedContainer ，它會定義邏輯上包含零個或多個其他元件的元件，而且是由父元件所擁有。 巢狀容器的行為與標準 Container 有幾種不同，包括下列各項：

• 和 之類的DesignModeGetService網站特性會透過擁有元件的月臺路由傳送。

• 月 Name 臺的 屬性是限定名稱，其中包含擁有元件的名稱，後面接著句號 (.) 和子元件的名稱。

• GetService 提供即服務的支援 INestedContainer 。

• 處置擁有元件時，也會處置容器。

此外，設計工具也會以不同的方式處理巢狀容器。 設計工具主機只對一個容器感興趣- 與主機相關聯的容器。 因此，當元件新增至巢狀容器或從巢狀容器中移除時，不會引發元件新增和移除事件。 不過，由於服務會流經巢狀容器，因此當巢狀容器中的元件變更時，會引發元件變更事件。

事件追蹤中的這種差異也會影響復原功能，這與串行化緊密相關。 標準復原引擎會使用 IReferenceService 來追蹤對元件所做的變更。 如果復原引擎無法透過參考服務識別元件的名稱，引擎將會忽略該元件的任何變更。 此服務只會在其擁有者中公開為相同名稱的公用只讀屬性時，才會自動辨識自主元件的變更。 否則，開發人員必須將元件變更事件傳遞至擁有者。 例如，如果巢狀元件 Text 的屬性以屬性的形式重新顯示於自己的元件 Address 上，當屬性變更時 Text ，必須以程序設計方式為對應的 Address 屬性進行屬性變更，否則復原將不會追蹤該變更。

建構函式

NestedContainer(IComponent)

初始化 NestedContainer 類別的新執行個體。

屬性

Components	取得 Container 中的所有元件。 (繼承來源 Container)
Owner	取得這個巢狀容器的主控元件。
OwnerName	取得主控元件的名稱。

方法

Add(IComponent)	將指定的 Component 加入至 Container。 元件未命名。 (繼承來源 Container)
Add(IComponent, String)	將指定的 Component 加入 Container，並指派名稱給它。 (繼承來源 Container)
CreateSite(IComponent, String)	為容器內的元件建立站台。
Dispose()	釋放 Container 所使用的所有資源。 (繼承來源 Container)
Dispose(Boolean)	釋放巢狀容器所使用的資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetService(Type)	取得指定型別的服務物件 (如果有的話)。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(IComponent)	從 Container 移除元件。 (繼承來源 Container)
RemoveWithoutUnsiting(IComponent)	從 Container 移除元件，而不必將 Site 設定為 null。 (繼承來源 Container)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
ValidateName(IComponent, String)	判斷元件名稱對這個容器而言是否唯一。 (繼承來源 Container)

另請參閱

• INestedContainer
• IContainer
• ISite
• IReferenceService