AddInStore Classe

  • Référence

Définition

Espace de noms:
System.AddIn.Hosting
Assembly:
System.AddIn.dll

Fournit les méthodes pour stocker et rechercher des informations sur les segments de pipeline et les compléments 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 des 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 de cache Méthodes qui créent le fichier
PipelineSegments.store

Ce fichier se trouve dans le répertoire racine de la structure de répertoires de pipeline.		 Update

Mises à jour le fichier avec de nouveaux segments de pipeline. Si aucun nouveau segment n’est installé, cette méthode valide simplement le cache.

Rebuild

Régénère 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

Mises à 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 de répertoires de pipeline.

Si aucun nouveau complément n’est installé, cette méthode valide simplement le cache.

RebuildAddIns

Régénère 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 de répertoires de pipeline.

Update

Si les compléments se trouvent dans la structure de répertoires 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 régénère 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 afin de rechercher tous les compléments qui correspondent à une vue 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 d’autoriser les utilisateurs ou entités non approuvés à 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

FindAddIn(Type, String, String, String)

Recherche un complément spécifique.
FindAddIns(Type, PipelineStoreLocation)

Recherche tous les compléments pour la vue de l'hôte du complément spécifiée à l'emplacement spécifié par la valeur d'énumération PipelineStoreLocation.
FindAddIns(Type, PipelineStoreLocation, String[])

Recherche tous les compléments pour la vue de l'hôte du complément spécifiée à l'emplacement spécifié par une valeur PipelineStoreLocation et un dossier Compléments facultatif.
FindAddIns(Type, String, String[])

Recherche tous les compléments pour la vue de l'hôte du complément spécifiée à partir d'un répertoire racine spécifié.
Rebuild(PipelineStoreLocation)

Reconstitue le cache des segments de pipeline et inclut de nouveaux segments à l'emplacement spécifié par une valeur PipelineStoreLocation.
Rebuild(String)

Reconstitue le cache des segments de pipeline et inclut de nouveaux segments à partir d'un répertoire racine spécifié.
RebuildAddIns(String)

Reconstitue 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 les nouveaux segments à l'emplacement spécifié par une valeur PipelineStoreLocation.
Update(String)

Met à jour le cache des segments de pipeline avec les 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é.

S’applique à

Voir aussi