NestedContainer Classe

Définition

Fournit l'implémentation de base pour l'interface INestedContainer qui permet aux conteneurs d'avoir un composant propriétaire.

public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::IContainer, System::ComponentModel::INestedContainer
public ref class NestedContainer : System::ComponentModel::Container, IDisposable, System::ComponentModel::INestedContainer
public ref class NestedContainer : System::ComponentModel::Container, System::ComponentModel::INestedContainer
public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.IContainer, System.ComponentModel.INestedContainer
public class NestedContainer : System.ComponentModel.Container, IDisposable, System.ComponentModel.INestedContainer
public class NestedContainer : System.ComponentModel.Container, System.ComponentModel.INestedContainer
type NestedContainer = class
    inherit Container
    interface IContainer
    interface IDisposable
    interface INestedContainer
type NestedContainer = class
    inherit Container
    interface INestedContainer
    interface IContainer
    interface IDisposable
Public Class NestedContainer
Inherits Container
Implements IContainer, IDisposable, INestedContainer
Public Class NestedContainer
Inherits Container
Implements IDisposable, INestedContainer
Public Class NestedContainer
Inherits Container
Implements INestedContainer
Héritage
NestedContainer
Implémente

Remarques

La NestedContainer classe est une implémentation simple de l’interface INestedContainer , qui définit un composant qui contient logiquement zéro ou plus d’autres composants et qui appartient à un composant parent. Le comportement des conteneurs imbriqués diffère d’une norme Container de plusieurs façons, y compris les éléments suivants :

  • Les caractéristiques du site telles que DesignMode et GetService sont routées via le site du composant propriétaire.

  • La propriété du Name site est un nom qualifié qui inclut le nom du composant propriétaire suivi d’un point (.) et le nom du composant enfant.

  • GetService assure la prise en charge du INestedContainer service en tant que service.

  • Lorsque le composant propriétaire est supprimé, le conteneur est également supprimé.

En outre, les concepteurs traitent les conteneurs imbriqués différemment. Un hôte de concepteur ne s’intéresse qu’à un seul conteneur , celui associé à l’hôte. Par conséquent, les événements d’ajout et de suppression de composant ne sont pas déclenchés lorsqu’un composant est ajouté ou supprimé d’un conteneur imbriqué. Toutefois, étant donné que les services transitent vers le conteneur imbriqué, les événements de modification de composant sont déclenchés lorsqu’un composant d’un conteneur imbriqué est modifié.

Cette disparité dans le suivi des événements a également un impact sur les fonctionnalités d’annulation, qui est étroitement liée à la sérialisation. Le moteur d’annulation standard utilise IReferenceService pour suivre les modifications apportées aux composants. Si le moteur d’annulation ne peut pas identifier un nom pour un composant via le service de référence, le moteur ignore les modifications apportées à ce composant. Ce service reconnaît automatiquement les modifications apportées aux composants contenus uniquement s’ils sont exposés en tant que propriétés en lecture seule publiques du même nom dans leurs propriétaires. Sinon, le développeur doit transmettre des événements de modification de composant jusqu’au propriétaire. Par exemple, si la propriété d’un Text Address composant imbriqué est resurface sur son propre composant en tant que propriété, lorsque la Text propriété est modifiée, une modification de propriété doit être effectuée par programmation pour la propriété correspondante Address ou si cette modification ne sera pas suivie par annulation.

Constructeurs

NestedContainer(IComponent)

Initialise une nouvelle instance de la classe NestedContainer.

Propriétés

Components

Obtient tous les composants du Container.

(Hérité de Container)
Owner

Obtient le composant propriétaire pour ce conteneur imbriqué.

OwnerName

Obtient le nom du composant propriétaire.

Méthodes

Add(IComponent)

Ajoute le Component spécifié à Container. Le composant est sans nom.

(Hérité de Container)
Add(IComponent, String)

Ajoute le Component spécifié à Container et lui assigne un nom.

(Hérité de Container)
CreateSite(IComponent, String)

Crée un site pour le composant dans le conteneur.

Dispose()

Libère toutes les ressources utilisées par Container.

(Hérité de Container)
Dispose(Boolean)

Libère les ressources utilisées par le conteneur imbriqué.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetService(Type)

Obtient l'objet service du type spécifié (si disponible).

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Remove(IComponent)

Supprime un composant de Container.

(Hérité de Container)
RemoveWithoutUnsiting(IComponent)

Supprime un composant de Container sans affecter à Site la valeur null.

(Hérité de Container)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
ValidateName(IComponent, String)

Détermine si le nom du composant est unique pour ce conteneur.

(Hérité de Container)

S’applique à

Voir aussi