services connexes et interfaces (contrôle de code source VSPackage)
cette section répertorie toutes les interfaces VSPackage-mises en relation par contrôle de code source dans Kit de développement logiciel Visual Studio. Le contrôle de code source VSPackage implémente certaines de ces interfaces et utilise les autres pour exécuter des tâches de contrôle de code source.
Interfaces implémentées par et de contrôle de code source VSPackages
Les interfaces suivantes sont décrites dans Kit de développement logiciel Visual Studio, et le contrôle de code source VSPackage implémente un sous-ensemble de ces selon son jeu de fonctionnalités souhaité. Certaines interfaces sont marquées comme étant obligatoire et doit être implémentée par chaque contrôle de code source VSPackage.
pour ces interfaces qu'un package n'implémente pas, Visual Studio fournit une implémentation par défaut. Notez que l'implémentation par défaut est conçu pour le cas lorsqu'un VSPackage n'est enregistré et aucun projet n'est contrôlé. Un contrôle de code source écrit correctement VSPackage implémente toutes les interfaces nécessaires au lieu d'un soin permettant à l'implémentation par défaut de ces interfaces.
Un contrôle de code source VSPackage doit implémenter un service en privé qui encapsule ou toutes les interfaces suivantes.
les interfaces sont :
requis : L'entité appropriée (contrôle de code source VSPackage, stub de contrôle de code source, projet) doit implémenter l'interface.
recommandé : L'entité doit implémenter cette interface ; sinon, les fonctionnalités de contrôle de code source peut être limitée.
facultatif : l'entité peut implémenter cette interface pour fournir un jeu de fonctionnalités plus riche.
Interface |
Objectif |
implémenté par |
implémentez ? |
|---|---|---|---|
les éditeurs appellent cette interface avant de modifier ou enregistrer un fichier. Le contrôle de code source VSPackage peut extraire le fichier ou refuser l'opération si l'extraction échoue. |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface fournit les fonctionnalités de base du contrôle de code source pour les projets, tels qu'enregistrer et d'annuler l'enregistrement des projets avec le contrôle de code source et fournir la prise en charge pour les glyphes de base de contrôle de code source. |
contrôle de code source VSPackage |
Obligatoire |
|
Cette interface dérive d' IVsHierarchy à l'aide de la fonction d' QueryInterface , ou caster uniquement l'objet implémentant IVsHierarchy à IVsSccProject2. Il est utilisé pour obtenir les fichiers sous contrôle de code source dans un projet ou pour informer le projet de l'état ou de l'emplacement actuel du contrôle de code source. |
Projet |
Obligatoire |
|
Le module d'intégration utilise cette interface pour définir le VSPackage actif. |
contrôle de code source VSPackage |
Obligatoire |
|
Cette interface est basé sur un type d'abonnement. Tout VSPackage peut signaler qu'il souhaite recevoir des événements de document et être recommandé par le shell sur les événements qui sont sur le point de se produire. il est implémenté et géré par Visual Studio, qui passe ensuite des événements implémentant IVsTrackProjectDocumentsEvents2 au VSPackage. |
stub de contrôle de code source |
Obligatoire |
|
Cette interface fournit le traitement par lot, les opérations en lecture/écriture synchronisées, et une méthode avancée de OnQueryAddFiles . |
stub de contrôle de code source |
Obligatoire |
|
Explorateur de solutions et les projets appellent cette interface lorsque de nouveaux fichiers sont ajoutés aux projets, ou lorsque les fichiers et les dossiers sont renommés ou supprimés des projets. Le contrôle de code source VSPackage peut extraire le fichier projet ou d'annuler l'opération. |
contrôle de code source VSPackage |
Recommandé |
|
Explorateur de solutions et les projets appellent cette interface en réponse à les appels effectués aux méthodes d'interface IVstrackProjectDocuments3. Le contrôle de code source VSPackage peut suivre des opérations par lot, les opérations en lecture/écriture synchronisées, et utiliser une méthode plus avancée de OnQueryAddFiles . |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface fournit la prise en charge de la gestion d'inscription pour les projets Web. |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface est utilisée pour récupérer des info-bulles pour les fichiers de contrôles utilisateur dans les projets. |
contrôle de code source VSPackage |
Facultatif |
|
Cette interface fournit la prise en charge d'extension de l'espace de noms. |
contrôle de code source VSPackage |
Facultatif |
|
Le VSPackage utilise cette interface pour intégrer une extension de l'espace de noms dans les boîtes de dialogue de Nouveau, d' Ouvrir, ou d' Enregistrer . Par conséquent, les projets peuvent être automatiquement ajoutés au contrôle de code source sur la conception, ou être ajoutés au contrôle de code source lorsqu'une opération de sauvegarde est appliquée. |
contrôle de code source VSPackage |
Facultatif |
|
Le VSPackage utilise cette interface pour définir des glyphes supplémentaires comme glyphes de contrôle de code source pour les nœuds dans Explorateur de solutions. |
contrôle de code source VSPackage |
Facultatif |
|
La boîte de dialogue d' Ajouter pour les projets Web utilise cette interface. Il fournit des méthodes pour rechercher un emplacement de contrôle de code source et pour ouvrir un projet Web auparavant ajouté dans le référentiel de contrôle de code source à cet emplacement. |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface fournit la prise en charge du chargement (d'arrière-plan) asynchrone des projets du contrôle de code source. |
contrôle de code source VSPackage |
Facultatif |
|
Cette interface permet aux projets de surveiller la progression du chargement asynchrone initialisée par IVsAsynchOpenFromScc. |
Projet |
Facultatif |
|
Cette interface permet à l'IDE pour interroger le contrôle de code source actif VSPackage. L'IDE interroge la valeur des paramètres de contrôle de code source qui ont une signification même s'il n'existe aucun contrôle de code source actif VSPackage enregistré. Cette interface est implémentée et managée par Visual Studio. |
stub de contrôle de code source |
Obligatoire |
|
cette interface est utilisée en enregistrant le contrôle de code source VSPackage. |
stub de contrôle de code source |
Obligatoire |
|
cette interface est utilisée dans l'automation. En tant que tel, il expose uniquement les fonctions qui peuvent être exécutées sans afficher tout interface utilisateur. |
contrôle de code source VSPackage |
Facultatif |
|
Cette interface est utilisée pour enregistrer les paramètres de contrôle de code source dans le fichier solution (.sln). Les paramètres sont les balises d'état de l'emplacement du contrôle de code source et du contrôle de code source. |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface est utilisée pour enregistrer les paramètres de contrôle de code source dans le fichier des options de solution (.suo). Cela peut inclure des paramètres spécifiques à l'utilisateur de contrôle de code source tels que l'emplacement de l'inscription de l'utilisateur actuel. |
contrôle de code source VSPackage |
Recommandé |
|
Cette interface est utilisée pour surveiller les événements afin d'exécuter des opérations telles que le contrôle dans les fichiers projet avant les solutions fermeture, ou l'obtention de fichiers du contrôle de code source en ouvrant un projet. |
contrôle de code source VSPackage |
Recommandé |
Voir aussi
Autres ressources
Éléments de création d'un VSPackage de contrôle de code source