Partager via

NestedContainer Classe

Définition

Espace de noms:
System.ComponentModel
Assemblys:
netstandard.dll, System.ComponentModel.TypeConverter.dll
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
NestedContainer.cs
Source:
NestedContainer.cs
Source:
NestedContainer.cs
Source:
NestedContainer.cs
Source:
NestedContainer.cs

Fournit l’implémentation de base de 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
Object
Container
NestedContainer
Implémente
IContainer INestedContainer IDisposable

Remarques

La NestedContainer classe est une implémentation simple de l’interface INestedContainer , qui définit un composant qui contient logiquement zéro ou plusieurs autres composants et 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 de 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 n’est intéressé que par 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 publique du même nom dans leurs propriétaires. Dans le cas contraire, le développeur doit transmettre les événements de modification de composant au propriétaire. Par exemple, si la propriété d’un Text composant imbriqué est resurcée 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 Address ou si cette modification ne sera pas suivie par annulation.

Constructeurs

Nom Description
NestedContainer(IComponent)

Initialise une nouvelle instance de la classe NestedContainer.

Propriétés

Nom Description
Components

Obtient tous les composants dans le Container.

(Hérité de Container)
Owner

Obtient le composant propriétaire de ce conteneur imbriqué.
OwnerName

Obtient le nom du composant propriétaire.

Méthodes

Nom Description
Add(IComponent, String)

Ajoute le nom spécifié à celui-ci ComponentContainer et lui attribue un nom.

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

Ajoute le paramètre spécifié Component au Container. Le composant n’est pas nommé.

(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 le 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()

Sert de fonction de hachage par défaut.

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

Obtient l’objet de service du type spécifié, s’il est disponible.
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

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

Supprime un composant du Container.

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

Supprime un composant de l’élément Container sans définir la valeur Sitenull.

(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