Partager via


Package, classe

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
Méthode protégée Package Initialise une nouvelle instance d'Package.

Début

Propriétés

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

Début

Méthodes

  Nom Description
Méthode protégée AddOptionKey Ajoute un nom de touche option d'utilisateur dans la liste de touches option.
Méthode publique CreateInstance Crée l'objet COM spécifié à l'aide de l'objet local de CLSID du Registre des vsprvs.
Méthode publique CreateTool Permet aux classes dérivées pour fournir une implémentation si nécessaire.
Méthode protégée CreateToolWindow Crée une fenêtre Outil du type spécifié avec l'ID spécifiée
Méthode protégée Dispose Libère les ressources utilisées par l'objet Package.
Méthode publique Equals Détermine si l'objet Object spécifié est égal à l'objet Object actuel. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique FindToolWindow Obtient la fenêtre Outil correspondant au type et à l'ID spécifiés
Méthode publique 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.
Méthode protégée GetAutomationObject Obtient l'objet Automation pour le VSPackage.
Méthode protégée GetDialogPage Obtient la page demandée de dialogue.
Méthode publiqueMembre statique 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.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetOutputPane Obtient la fenêtre Sortie demandée.
Méthode publique GetProviderLocale Retourne les paramètres régionaux associés à ce fournisseur de services.
Méthode protégée GetService Gets type- a basé des services du conteneur de service d'un VSPackage.
Méthode protégée 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.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée Initialize Appelé lorsque le VSPackage est chargé par Visual Studio.
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégée OnLoadOptions Appelé par la classe de package lorsqu'il y a des options d'être lues à partir du fichier solution.
Méthode protégée OnSaveOptions Appelé par la classe d'Package lorsqu'il y a des options d'être enregistrées au fichier solution.
Méthode protégée 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.
Méthode protégée 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.
Méthode protégée QueryClose Appelé pour demander au package si le shell peut être fermé.
Méthode protégée RegisterEditorFactory Enregistre une fabrique d'éditeur avec Visual Studio.
Méthode protégée RegisterProjectFactory Enregistre une fabrique de projet avec Visual Studio.
Méthode publique ShowOptionPage Affiche une page d'options spécifiée d'outils.
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

  Nom Description
Événement protégé ToolboxInitialized Événement généré chaque fois que Visual Studio initialise son boîte à outils.
Événement protégé 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
Implémentation d'interface expliciteMéthode privée IServiceContainer.AddService(Type, ServiceCreatorCallback) Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
Implémentation d'interface expliciteMéthode privée IServiceContainer.AddService(Type, Object) Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
Implémentation d'interface expliciteMéthode privée IServiceContainer.AddService(Type, ServiceCreatorCallback, Boolean) Ajoute le service donné au conteneur de service au moyen de ServiceCreatorCallback spécifié.
Implémentation d'interface expliciteMéthode privée IServiceContainer.AddService(Type, Object, Boolean) Infrastructure. Ajoute le service donné au conteneur du service du VSPackage.
Implémentation d'interface expliciteMéthode privée IServiceProvider.GetService Obtient le service du type spécifié.
Implémentation d'interface expliciteMéthode privée IServiceContainer.RemoveService(Type) Infrastructure. Supprime le type de service donné du conteneur de service.
Implémentation d'interface expliciteMéthode privée 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.
Implémentation d'interface expliciteMéthode privée IOleCommandTarget.Exec Exécute une commande spécifiée ou les affichages aident pour une commande.
Implémentation d'interface expliciteMéthode privée 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.
Implémentation d'interface expliciteMéthode privée IServiceProvider.QueryService Infrastructure. Implémentation interne d'IServiceProvider.
Implémentation d'interface expliciteMéthode privée IVsPackage.Close Infrastructure. Ferme et supprime le package.
Implémentation d'interface expliciteMéthode privée IVsPackage.GetAutomationObject Infrastructure. Obtient un objet automation- convivial pour ce package.
Implémentation d'interface expliciteMéthode privée 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.
Implémentation d'interface expliciteMéthode privée IVsPackage.QueryClose Infrastructure. Appelé pour demander le VSPackage si le shell de Visual Studio peut être fermé.
Implémentation d'interface expliciteMéthode privée IVsPackage.ResetDefaults Infrastructure. Valeurs par défaut de boîte à outils de remises.
Implémentation d'interface expliciteMéthode privée IVsPackage.SetSite Infrastructure. Initialise le VSPackage dans l'environnement de Visual Studio.
Implémentation d'interface expliciteMéthode privée IVsPersistSolutionOpts.LoadUserOptions Infrastructure. Charge des options d'utilisateur pour une solution donnée.
Implémentation d'interface expliciteMéthode privée IVsPersistSolutionOpts.ReadUserOptions Infrastructure. Lit des options d'utilisateur pour une solution donnée.
Implémentation d'interface expliciteMéthode privée IVsPersistSolutionOpts.SaveUserOptions Infrastructure. Enregistre des options d'utilisateur pour une solution donnée.
Implémentation d'interface expliciteMéthode privée IVsPersistSolutionOpts.WriteUserOptions Infrastructure. Écrit des options d'utilisateur pour une solution donnée.
Implémentation d'interface expliciteMéthode privée IVsToolboxItemProvider.GetItemContent Obtient un élément.
Implémentation d'interface expliciteMéthode privée IVsToolWindowFactory.CreateToolWindow Infrastructure. Crée une fenêtre Outil du type spécifié avec l'ID spécifiée
Implémentation d'interface expliciteMéthode privé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.
Implémentation d'interface expliciteMéthode privée 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.
Implémentation d'interface expliciteMéthode privée IVsUserSettingsMigration.MigrateSettings Migre des paramètres d'une version antérieur.
Implémentation d'interface expliciteMéthode privée 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.

Voir aussi

Référence

Microsoft.VisualStudio.Shell, espace de noms

IVsPackage

Autres ressources

VSPackages managé

Les VSPackages et managed package

Stocker les VSPackages