AddInStore Classe

Définition

Espace de noms:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Fournit des méthodes pour stocker et trouver des informations sur les compléments et segments de pipeline disponibles.

public ref class AddInStore abstract sealed

public static class AddInStore

type AddInStore = class

Public Class AddInStore

Héritage

Object

AddInStore

Exemples

L’exemple suivant montre comment mettre à jour les fichiers de cache.

// Get path for the pipeline root.
// Assumes that the current directory is the
// pipeline directory structure root directory.
String pipeRoot = Environment.CurrentDirectory;

// Update the cache files of the
// pipeline segments and add-ins.
string[] warnings = AddInStore.Update(pipeRoot);

foreach (string warning in warnings)
{
    Console.WriteLine(warning);
}

// Search for add-ins of type Calculator (the host view of the add-in)
// specifying the host's application base, instead of a path,
// for the FindAddIns method.

Collection<AddInToken> tokens =
            AddInStore.FindAddIns(typeof(Calculator), PipelineStoreLocation.ApplicationBase);

' Get the path for the pipeline root.  
' Assumes that the current directory is the
' pipline directory structure root directory.
Dim pipeRoot As String = Environment.CurrentDirectory
' Update the cache files of the
' pipeline segments and add-ins.
Dim warnings() As String = AddInStore.Update(pipeRoot)
For Each warning As String In warnings
    Console.WriteLine(warning)
Next

' Search for add-ins of type Calculator (the host view of the add-in)
' specifying the host's application base, instead of a path,
' for the FindAddIns method.
Dim tokens As Collection(Of AddInToken) =
    AddInStore.FindAddIns(GetType(Calculator), PipelineStoreLocation.ApplicationBase)

Remarques

Utilisez cette classe pour générer, reconstruire et mettre à jour deux fichiers de cache, comme décrit dans le tableau suivant.

Fichier cache	Méthodes qui créent le fichier
PipelineSegments.store Ce fichier se trouve dans le répertoire racine de la structure du répertoire de pipeline.	Update Met à jour le fichier avec de nouveaux segments de pipeline. Si aucun nouveau segment n’est installé, cette méthode valide simplement le cache. Rebuild Reconstruit le fichier et inclut de nouveaux segments de pipeline.
AddIns.store Ce fichier se trouve dans un répertoire qui contient un ou plusieurs sous-répertoires de complément. Si ce répertoire se trouve dans la structure de répertoires de pipeline, il doit être nommé AddIns.	UpdateAddIns Met à jour le fichier avec de nouveaux compléments à un emplacement spécifié. Appelez cette méthode si vos compléments se trouvent en dehors de la structure du répertoire du pipeline. Si aucun nouveau complément n’est installé, cette méthode valide simplement le cache. RebuildAddIns Reconstruit le fichier et inclut des compléments à un emplacement spécifié. Appelez cette méthode si vos compléments se trouvent en dehors de la structure du répertoire du pipeline. Update Si les compléments se trouvent dans la structure du répertoire de pipeline, cette méthode met à jour le fichier avec de nouveaux compléments. Rebuild Si les compléments se trouvent dans la structure du répertoire de pipeline, cette méthode reconstruit le fichier et inclut de nouveaux compléments.

Ces méthodes créent les fichiers de cache s’ils n’existent pas précédemment.

Une fois les fichiers de cache créés, utilisez la FindAddIns méthode pour examiner les fichiers pour rechercher tous les compléments qui correspondent à une vue d’hôte spécifiée du complément. Vous pouvez également utiliser la FindAddIn méthode pour rechercher un complément spécifique.

Important

Il n’est pas pris en charge pour permettre aux utilisateurs ou entités non approuvés d’accéder à PipelineSegments.store et Addins.store. Cela peut entraîner des problèmes d’altération des données pour les applications.

Méthodes

Nom	Description
FindAddIn(Type, String, String, String)	Recherche un complément spécifique.
FindAddIns(Type, PipelineStoreLocation, String[])	Recherche tous les compléments pour une vue hôte spécifiée du complément à l’emplacement spécifié par une PipelineStoreLocation valeur et un dossier de compléments facultatifs.
FindAddIns(Type, PipelineStoreLocation)	Recherche tous les compléments pour une vue hôte spécifiée du complément à un emplacement spécifié par la PipelineStoreLocation valeur d’énumération.
FindAddIns(Type, String, String[])	Recherche tous les compléments pour une vue hôte spécifiée du complément à partir d’un répertoire racine spécifié.
Rebuild(PipelineStoreLocation)	Reconstruit le cache des segments de pipeline et inclut de nouveaux segments à l’emplacement spécifié par une PipelineStoreLocation valeur.
Rebuild(String)	Reconstruit le cache des segments de pipeline et inclut de nouveaux segments à partir d’un répertoire racine spécifié.
RebuildAddIns(String)	Reconstruit le cache du complément et inclut de nouveaux compléments à partir d’un répertoire racine spécifié.
Update(PipelineStoreLocation)	Met à jour le cache des segments de pipeline avec de nouveaux segments à l’emplacement spécifié par une PipelineStoreLocation valeur.
Update(String)	Met à jour le cache des segments de pipeline avec de nouveaux segments à partir d’un répertoire racine spécifié.
UpdateAddIns(String)	Met à jour le cache du complément et inclut de nouveaux compléments à un emplacement spécifié.