Provides the base implementation for the INestedContainer interface, which enables containers to have an owning component.
public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::INestedContainer
public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.INestedContainer
type NestedContainer = class inherit Container interface INestedContainer interface IContainer interface IDisposable
Public Class NestedContainer Inherits Container Implements IDisposable, INestedContainer
The NestedContainer class is a simple implementation of the INestedContainer interface, which defines a component that logically contains zero or more other components and is owned by a parent component. The behavior of nested containers differs from a standard Container in a number of ways, including the following:
The site’s Name property is a qualified name that includes the owning component’s name followed by a period (.) and the child component’s name.
When the owning component is disposed, the container is disposed as well.
In addition, designers treat nested containers differently. A designer host is only interested in one container—the one associated with the host. Therefore, component add and remove events are not raised when a component is added to or removed from a nested container. However, because services flow through to the nested container, component change events are raised when a component in a nested container is changed.
This disparity in event tracking also impacts undo functionality, which is closely tied to serialization. The standard undo engine uses IReferenceService to track changes made to components. If the undo engine cannot identify a name for a component through the reference service, the engine will ignore any changes for that component. This service automatically recognizes changes to contained components only if they are exposed as public read-only properties of the same name in their owners. Otherwise, the developer must pass component change events up to the owner. For example, if a nested component’s
Text property is resurfaced on its owning component as an
Address property, when the
Text property is changed, a property change must be programmatically made for the corresponding
Address property or else that change will not be tracked by undo.
|NestedContainer(IComponent) NestedContainer(IComponent) NestedContainer(IComponent) NestedContainer(IComponent)||
Initializes a new instance of the NestedContainer class.
|Components Components Components Components||
Gets all the components in the Container.(Inherited from Container)
|Owner Owner Owner Owner||
Gets the owning component for this nested container.
|OwnerName OwnerName OwnerName OwnerName||
Gets the name of the owning component.