Package, classe

Article
08/01/2012

Fournit une implémentation managée des interfaces requises pour créer quatre arcs - VSPackage fonctionnel.

Hiérarchie d'héritage

System.Object
Microsoft.VisualStudio.Shell.Package
Microsoft.VisualStudio.Shell.ExtensionPointPackage

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

Syntaxe

'Déclaration
<ComVisibleAttribute(True)> _
<PackageRegistrationAttribute> _
Public MustInherit Class Package _
    Implements IVsPackage, IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts,  _
    IServiceContainer, IServiceProvider, IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery,  _
    IVsToolWindowFactory, IVsToolboxItemProvider

[ComVisibleAttribute(true)]
[PackageRegistrationAttribute]
public abstract class Package : IVsPackage, 
    IServiceProvider, IOleCommandTarget, IVsPersistSolutionOpts, IServiceContainer, IServiceProvider, 
    IVsUserSettings, IVsUserSettingsMigration, IVsUserSettingsQuery, IVsToolWindowFactory, IVsToolboxItemProvider

Le type Package expose les membres suivants.

Constructeurs

	Nom	Description
	Package	Initialise une nouvelle instance d'Package.

Début

Propriétés

	Nom	Description
	ApplicationRegistryRoot	Obtient la clé de Registre de racine de la ruche actuelle de Registre de Visual Studio.
	UserDataPath	Obtient le chemin d'accès au stockage des données d'utilisateur pour Visual Studio.
	UserLocalDataPath	Obtient le chemin d'accès au stockage des données local d'utilisateur pour Visual Studio.
	UserRegistryRoot	Obtient une clé de Registre qui peut être utilisée pour enregistrer des données d'utilisateur.
	Zombied	Obtient une valeur indiquant si le package en cours de arrêt.

Début

Méthodes

	Nom	Description
	AddOptionKey	Ajoute un nom de touche option d'utilisateur dans la liste de touches option.
	CreateInstance	Crée l'objet COM spécifié à l'aide de l'objet local de CLSID du Registre des vsprvs.
	CreateTool	Permet aux classes dérivées pour fournir une implémentation si nécessaire.
	CreateToolWindow	Crée une fenêtre Outil du type spécifié avec l'ID spécifiée
	Dispose	Libère les ressources utilisées par l'objet Package.
	Equals	Détermine si l'objet Object spécifié est égal à l'objet Object actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	FindToolWindow	Obtient la fenêtre Outil correspondant au type et à l'ID spécifiés
	FindWindowPane	Obtient le volet de fenêtre correspondant au type et à l'IDENTIFICATEUR spécifiés, et si aucun volet de fenêtre de ce type n'existe crée un si indique de le faire.
	GetAutomationObject	Obtient l'objet Automation pour le VSPackage.
	GetDialogPage	Obtient la page demandée de dialogue.
	GetGlobalService	Obtient un service offert globalement par Visual Studio ou un de ses packages. C'est le même qu'GetService appelant () sur une instance d'un package qui n'offre aucun service lui-même.
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetOutputPane	Obtient la fenêtre Sortie demandée.
	GetProviderLocale	Retourne les paramètres régionaux associés à ce fournisseur de services.
	GetService	Gets type- a basé des services du conteneur de service d'un VSPackage.
	GetToolboxItemData	Obtient le contenu du format de données pour l'ID d'élément et le format de données spécifiés de boîte à outils.
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	Initialize	Appelé lorsque le VSPackage est chargé par Visual Studio.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
	OnLoadOptions	Appelé par la classe de package lorsqu'il y a des options d'être lues à partir du fichier solution.
	OnSaveOptions	Appelé par la classe d'Package lorsqu'il y a des options d'être enregistrées au fichier solution.
	ParseToolboxResource(TextReader, Guid)	Analyse une ressource embarquée en texte de format approprié des informations concernant le type des éléments doivent être ajoutés à boîte à outils.
	ParseToolboxResource(TextReader, ResourceManager)	Analyse une ressource embarquée en texte de format approprié des informations concernant le type des éléments doivent être ajoutés à boîte à outils.
	QueryClose	Appelé pour demander au package si le shell peut être fermé.
	RegisterEditorFactory	Enregistre une fabrique d'éditeur avec Visual Studio.
	RegisterProjectFactory	Enregistre une fabrique de projet avec Visual Studio.
	ShowOptionPage	Affiche une page d'options spécifiée d'outils.
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

	Nom	Description
	ToolboxInitialized	Événement généré chaque fois que Visual Studio initialise son boîte à outils.
	ToolboxUpgraded	Événement généré chaque fois que Visual Studio met à niveau son boîte à outils.

Début

Implémentations d'interface explicite

	Nom	Description
	IServiceContainer.AddService(Type, ServiceCreatorCallback)	Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
	IServiceContainer.AddService(Type, Object)	Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
	IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean)	Ajoute le service donné au conteneur de service au moyen de ServiceCreatorCallback spécifié.
	IServiceContainer.AddService(Type, Object, Boolean)	Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
	IServiceProvider.GetService	Obtient le service du type spécifié.
	IServiceContainer.RemoveService(Type)	Infrastructure. Supprime le type de service donné du conteneur de service.
	IServiceContainer.RemoveService(Type, Boolean)	Infrastructure. Supprime le type de service donné du conteneur de service, et encourage éventuellement la suppression du service dans les conteneurs parents de service.
	IOleCommandTarget.Exec	Exécute une commande spécifiée ou les affichages aident pour une commande.
	IOleCommandTarget.QueryStatus	Interroge l'objet sur l'état d'une ou de plusieurs commandes générées par les événements d'interface utilisateur.
	IServiceProvider.QueryService	Infrastructure. Implémentation interne d'IServiceProvider.
	IVsPackage.Close	Infrastructure. Ferme et supprime le package.
	IVsPackage.GetAutomationObject	Infrastructure. Obtient un objet automation- convivial pour ce package.
	IVsPackage.GetPropertyPage	Infrastructure. Accès de Proffers au menu Options d'Outils et les pages de propriétés des boîtes de dialogue de Personnaliser la boîte à outils.
	IVsPackage.QueryClose	Infrastructure. Appelé pour demander le VSPackage si le shell de Visual Studio peut être fermé.
	IVsPackage.ResetDefaults	Infrastructure. Valeurs par défaut de boîte à outils de remises.
	IVsPackage.SetSite	Infrastructure. Initialise le VSPackage dans l'environnement de Visual Studio.
	IVsPersistSolutionOpts.LoadUserOptions	Infrastructure. Charge des options d'utilisateur pour une solution donnée.
	IVsPersistSolutionOpts.ReadUserOptions	Infrastructure. Lit des options d'utilisateur pour une solution donnée.
	IVsPersistSolutionOpts.SaveUserOptions	Infrastructure. Enregistre des options d'utilisateur pour une solution donnée.
	IVsPersistSolutionOpts.WriteUserOptions	Infrastructure. Écrit des options d'utilisateur pour une solution donnée.
	IVsToolboxItemProvider.GetItemContent	Obtient un élément.
	IVsToolWindowFactory.CreateToolWindow	Infrastructure. Crée une fenêtre Outil du type spécifié avec l'ID spécifiée
	IVsUserSettings.ExportSettings	Cette méthode implémente l'interface d'IVsUserSettings utilisée pour gérer des profils et pour les importer/paramètres d'exportation aux fichiers XML.
	IVsUserSettings.ImportSettings	Extrait la configuration d'un VSPackage à l'aide de le mécanisme de paramètres de Visual Studio lorsqu'un utilisateur sélectionne l'option d'importation de la fonctionnalité de Paramètres d'importation/exportation sur le menu Outils d'IDE.Cette méthode fait partie de l'implémentation de l'interface d'IVsUserSettings utilisée pour gérer des profils et pour les importer/paramètres d'exportation aux fichiers XML.
	IVsUserSettingsMigration.MigrateSettings	Migre des paramètres d'une version antérieur.
	IVsUserSettingsQuery.NeedExport

Début

Remarques

La classe d'Package fournit une implémentation managée de plusieurs des interfaces de VSIP les plus utiles.Vous pouvez créer la fonctionnalité de base d'un VSPackage avec très peu de code en dérivant de la classe d'Package, en substituant certaines de ses méthodes, et en joignant des classes d'attributs d'alignement.La classe d'Package ne fournit pas la prise en charge directe d'alignement, mais elle peut utiliser des classes d'attributs pour fournir les informations d'inscription nécessaires aux outils externes tels que RegPkg.exe.

La classe d'Package offre les services suivants par défaut.(Vous pouvez les remplacer en demandant le VSPackage IServiceContainer, en les supprimant, et en ajoutant vos propres services à leur place.)

Package

Le package s'offre en tant que service.
IServiceContainer

Fournit la capacité d'ajouter et supprimer des services.En entretiennent ajouté par « les encouragent » défini à true sont proposés à Visual Studio via IProfferService.Cela rend le service global à tous les VSPackages dans Visual Studio.(Ce service est disponible uniquement si le VSPackage a été déjà chargé.)

Outre ces services, Package utilise l'architecture de service de Visual Studio pour permettre d'accéder à n'importe quel service disponible via le fournisseur de services global.

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.