AddInStore Klasse

Definition

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Stellt Methoden zum Speichern und Suchen von Informationen über verfügbare Add-Ins und Pipelinesegmente bereit.

public ref class AddInStore abstract sealed

public static class AddInStore

type AddInStore = class

Public Class AddInStore

Vererbung

Object

AddInStore

Beispiele

Das folgende Beispiel zeigt, wie Cachedateien aktualisiert werden.

// 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)

Hinweise

Verwenden Sie diese Klasse, um zwei Cachedateien zu erstellen, neu zu erstellen und zu aktualisieren, wie in der folgenden Tabelle beschrieben.

Cachedatei	Methoden zum Erstellen der Datei
PipelineSegments.store Diese Datei befindet sich im Stammverzeichnis der Pipelineverzeichnisstruktur.	Update Updates die Datei mit neuen Pipelinesegmenten. Wenn keine neuen Segmente installiert sind, überprüft diese Methode nur den Cache. Rebuild Erstellt die Datei neu und schließt neue Pipelinesegmente ein.
AddIns.store Diese Datei befindet sich in einem Verzeichnis, das mindestens ein Add-In-Unterverzeichnis enthält. Wenn sich dieses Verzeichnis in der Pipelineverzeichnisstruktur befindet, muss es den Namen AddIns haben.	UpdateAddIns Updates die Datei mit neuen Add-Ins an einem angegebenen Speicherort. Rufen Sie diese Methode auf, wenn sich Ihre Add-Ins außerhalb der Pipelineverzeichnisstruktur befinden. Wenn keine neuen Add-Ins installiert sind, überprüft diese Methode einfach den Cache. RebuildAddIns Erstellt die Datei neu und schließt Add-Ins an einem angegebenen Speicherort ein. Rufen Sie diese Methode auf, wenn sich Ihre Add-Ins außerhalb der Pipelineverzeichnisstruktur befinden. Update Wenn sich die Add-Ins in der Pipelineverzeichnisstruktur befinden, aktualisiert diese Methode die Datei mit neuen Add-Ins. Rebuild Wenn sich die Add-Ins in der Pipelineverzeichnisstruktur befinden, erstellt diese Methode die Datei neu und schließt neue Add-Ins ein.

Diese Methoden erstellen die Cachedateien, wenn sie zuvor noch nicht vorhanden sind.

Nachdem die Cachedateien erstellt wurden, verwenden Sie die FindAddIns -Methode, um die Dateien zu untersuchen, um alle Add-Ins zu finden, die einer angegebenen Hostansicht des Add-Ins entsprechen. Sie können auch die FindAddIn -Methode verwenden, um ein bestimmtes Add-In zu finden.

Wichtig

Es wird nicht unterstützt, nicht vertrauenswürdigen Benutzern oder Entitäten den Zugriff auf PipelineSegments.store und Addins.store zu ermöglichen. Dies kann zu Datenbeschädigungen für Anwendungen führen.

Methoden

FindAddIn(Type, String, String, String)	Sucht ein bestimmtes Add-In.
FindAddIns(Type, PipelineStoreLocation)	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an dem vom PipelineStoreLocation-Enumerationswert angegebenen Speicherort.
FindAddIns(Type, PipelineStoreLocation, String[])	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an dem von einem PipelineStoreLocation-Wert angegebenen Speicherort und einem optionalen Add-In-Ordner.
FindAddIns(Type, String, String[])	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins in einem angegebenen Stammverzeichnis.
Rebuild(PipelineStoreLocation)	Erstellt den Pipelinesegmentcache neu und schließt neue Segmente am von einem PipelineStoreLocation-Wert angegebenen Speicherort ein.
Rebuild(String)	Erstellt den Pipelinesegmentcache neu und schließt neue Segmente aus einem angegebenen Stammverzeichnis ein.
RebuildAddIns(String)	Erstellt den Add-In-Cache neu und schließt neue Add-Ins aus einem angegebenen Stammverzeichnis ein.
Update(PipelineStoreLocation)	Aktualisiert den Pipelinesegmentcache mit neuen Segmenten am von einem PipelineStoreLocation-Wert angegebenen Speicherort.
Update(String)	Aktualisiert den Pipelinesegmentcache mit neuen Segmenten aus einem angegebenen Stammverzeichnis.
UpdateAddIns(String)	Aktualisiert den Add-In-Cache und schließt neue Add-Ins an einem angegebenen Speicherort ein.

Weitere Informationen

• Add-Ins und Erweiterbarkeit