INestedContainer Schnittstelle

Definition

Stellt Funktionalität für geschachtelte Container bereit, die logisch 0 (null) oder mehr Komponenten enthalten und von einer übergeordneten Komponente besessen werden.Provides functionality for nested containers, which logically contain zero or more other components and are owned by a parent component.

public interface class INestedContainer : IDisposable, System::ComponentModel::IContainer
public interface INestedContainer : IDisposable, System.ComponentModel.IContainer
type INestedContainer = interface
    interface IContainer
    interface IDisposable
Public Interface INestedContainer
Implements IContainer, IDisposable
Abgeleitet
Implementiert

Hinweise

Die INestedContainer -Schnittstelle fügt der- IContainer Schnittstelle das Konzept einer besitzenden Komponente hinzu.The INestedContainer interface adds the concept of an owning component to the IContainer interface. Bei einem in einem Container enthaltenen Container handelt es sich um ein Objekt, das logisch, aber nicht notwendigerweise visuell, NULL oder mehr untergeordnete Komponenten enthält und sich im Besitz einer übergeordneten Komponente befindet.A nested container is an object that logically, but not necessarily visually, contains zero or more child components and is owned by some parent component. Bei der visuellen Kapselung ist die besitzende Komponente häufig ein anderer Container.For visual containment, the owning component is often another container.

Durch die Verwendung von untergeordneten Containern können Abschnitte eines Steuer Elements entworfen werden, ohne dass eine explizite serialisierte Member-Variable oder ein benutzerdefiniertes Serialisierungsprogramm für jedes unter Steuerelement erforderlich ist.Nested containers allow sections of a control to be designable, without requiring an explicit serialized member variable or a custom serializer for each subcontrol. Stattdessen verwaltet der Formular-Designer einen Master Container von-Komponenten.Instead, the form designer maintains one master container of components. Der Standort jeder Komponente verfügt möglicherweise über einen Container, der einen Ort zum Einfügen zusätzlicher Komponenten bereitstellt.Each component's site may have a nested container that provides a place to put extra components. Wenn eine Komponente in einem in einem Container enthaltenen Container positioniert ist, ist der empfangene Name eine Kombination aus dem angegebenen Namen und dem Namen der besitzenden Komponente.When a component is sited in a nested container, the name it receives is a combination of its given name and its owning component's name. Darüber hinaus haben Komponenten, die einem Container mit einem Container hinzugefügt werden, Vollzugriff auf die Dienste des übergeordneten Containers, und der untergeordnete Container bietet das gleiche Verhalten wie das übergeordnete Container in Bezug auf das Hinzufügen neuer Komponenten.Additionally, components added to a nested container have full access to the services of the parent container, and the nested container provides the same behavior of the parent with respect to adding new components. Der Container erstellt den Designer für jede enthaltene Komponente und aktiviert so die Unterstützung für die Entwurfszeit.The nested container will create the designer for each component it contains, thereby enabling design-time support. Da standardcodeserialisierungsinitialisierer nicht in der Liste der in einem Container genannten Container angezeigt werden, werden diese Komponenten nur serialisiert, wenn Sie durch das Durchlaufen der Komponenten im primären Container abgerufen werden können.Because standard code serializers do not look at nested containers, these components are only serialized if a path to them can be obtained by walking the components in the primary container.

Sie können sich durch die Abfrage eines Komponenten Standorts für Dienste des Typs INestedContainereinen Container befinden.Nested containers can be found by querying a component's site for services of type INestedContainer.

Eigenschaften

Components

Ruft alle Komponenten im IContainer ab.Gets all the components in the IContainer.

(Geerbt von IContainer)
Owner

Ruft die besitzende Komponente für den geschachtelten Container ab.Gets the owning component for the nested container.

Methoden

Add(IComponent)

Fügt dem IComponent am Ende der Liste die angegebene IContainer hinzu.Adds the specified IComponent to the IContainer at the end of the list.

(Geerbt von IContainer)
Add(IComponent, String)

Fügt dem IComponent am Ende der Liste die angegebene IContainer hinzu und weist der Komponente einen Namen zu.Adds the specified IComponent to the IContainer at the end of the list, and assigns a name to the component.

(Geerbt von IContainer)
Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Geerbt von IDisposable)
Remove(IComponent)

Entfernt eine Komponente aus dem IContainer.Removes a component from the IContainer.

(Geerbt von IContainer)

Gilt für:

Siehe auch