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' INestedContainer interface, qui définit un composant qui contient logiquement zéro, un ou plusieurs autres composants et qui appartient à un composant parent. Le comportement des conteneurs imbriqués diffère d’une norme Container de plusieurs façons, notamment les suivantes :

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

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

  • GetService prend en charge le INestedContainer 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 n’est intéressé que par un seul conteneur, celui qui est associé à l’hôte. Par conséquent, les événements d’ajout et de suppression de composants ne sont pas déclenchés lorsqu’un composant est ajouté ou supprimé d’un conteneur imbriqué. Toutefois, étant donné que les services sont transmis au conteneur imbriqué, les événements de modification de composant sont déclenchés quand un composant d’un conteneur imbriqué est modifié.

Cette disparité dans le suivi des événements a également un impact sur la fonctionnalité d’annulation, qui est étroitement liée à la sérialisation. Le moteur d’annulation standard utilise IReferenceService pour effectuer le suivi des modifications apportées aux composants. Si le moteur d’annulation ne peut pas identifier un nom pour un composant par le biais du 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 portant le même nom dans leurs propriétaires. Dans le cas contraire, le développeur doit passer des événements de modification de composant jusqu’au propriétaire. Par exemple, si la propriété d’un composant imbriqué Text est redéfinie sur son composant propriétaire en tant que Address 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, sinon cette modification n’est Address pas suivie par l’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