DesignSurfaceExtension, classe

Article
08/01/2012

La classe de base pour tout objet fourni par un VSPackage à appeler par l'environnement de Visual Studio lors de la création conceptrice pour personnaliser ou étendre des services et des métadonnées a fourni par toute implémentation d'DesignSurface.

Hiérarchie d'héritage

System.Object
Microsoft.VisualStudio.Shell.Design.DesignSurfaceExtension

Espace de noms : Microsoft.VisualStudio.Shell.Design
Assembly : Microsoft.VisualStudio.Shell.Design (dans Microsoft.VisualStudio.Shell.Design.dll)

Syntaxe

'Déclaration
<ComVisibleAttribute(True)> _
Public MustInherit Class DesignSurfaceExtension _
    Implements IDisposable

[ComVisibleAttribute(true)]
public abstract class DesignSurfaceExtension : IDisposable

Le type DesignSurfaceExtension expose les membres suivants.

Constructeurs

	Nom	Description
	DesignSurfaceExtension	Crée une nouvelle instance de la classe DesignSurfaceExtension.

Début

Propriétés

	Nom	Description
	Surface	Obtient l'aire de conception que que cette extension a été initialisée avec.

Début

Méthodes

	Nom	Description
	Dispose()	Dispose cet objet et ses ressources.
	Dispose(Boolean)	Dispose cet objet et ses ressources.
	Equals	Détermine si l'objet Object spécifié est égal à l'objet Object actuel. (Hérité de Object.)
	Finalize	Détruit l'objet. (Substitue Object.Finalize().)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	Initialize	Initialise l'extension d'aire de conception.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	OnComponentCreated	Cette méthode est appelée lorsqu'un nouveau composant est créé mais avant ce composant est ajouté au générateur.
	OnDesignerCreated(IDesigner)	Obsolète. Cette méthode est appelée lorsqu'un nouveau générateur est créé.
	OnDesignerCreated(IComponent, IDesigner, Boolean)	Cette méthode est appelée lorsqu'un nouveau générateur est créé.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Remarques

l'objet d'DesignSurfaceExtension doit être enregistré en appliquant les instances suivantes d'Attribute appliquées à l'implémentation d'Package d'un VSPackage :

DesignSurfaceExtensionAttribute pour informer l'environnement de Visual Studio ce l'implémentation d'DesignSurfaceExtension comme fourniture de la personnalisation de l'aire de conception au moment de le chargement concepteur.
ProvideObjectAttribute à indiquer que le VSPackage fournit des instances de l'objet d'DesignSurfaceExtension.
ProvideServiceAttribute à indiquer que l'implémentation d'DesignSurfaceExtension est fournie par le VSPackage en tant que service de Visual Studio SDK.

Une application déjà chargée par l'environnement de Visual Studio peut fournir la modification dynamique des services ou des métadonnées d'une aire du concepteur à la surface ou la création de composant en gérant l'événement d'DesignerCreated.

Toutefois, comme les VSPackages sont une demande chargée, un package ne peut avoir été chargé par l'environnement de Visual Studio avant le chargement d'une aire de conception, et ne peut donc pas en DesignerCreated abonner à l'événement.

Pour résoudre ce problème, chaque fois que les aires de conception ou composant de concepteur est créées, l'environnement de Visual Studio crée des instances d'DesignSurfaceExtension enregistré et les applique à la surface ou au composant créée.

Cela garantit qu'un VSPackage concepteur commencer des modifications sont correctement exécutés et le VSPackage lui-même est chargé autant que nécessaire.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.