AddInStore Classe

Definizione

Spazio dei nomi:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Fornisce metodi per archiviare e individuare informazioni sui componenti aggiuntivi e sui segmenti di pipeline disponibili.

public ref class AddInStore abstract sealed

public static class AddInStore

type AddInStore = class

Public Class AddInStore

Ereditarietà

Object

AddInStore

Esempio

Nell'esempio seguente viene illustrato come aggiornare i file della 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)

Commenti

Usare questa classe per compilare, ricompilare e aggiornare due file della cache, come descritto nella tabella seguente.

File della cache	Metodi che creano il file
PipelineSegments.store Questo file si trova nella directory radice della struttura di directory della pipeline.	Update Aggiornamenti il file con nuovi segmenti di pipeline. Se non sono installati nuovi segmenti, questo metodo convalida solo la cache. Rebuild Ricompila il file e include nuovi segmenti di pipeline.
AddIns.store Questo file si trova in una directory che contiene una o più sottodirectory del componente aggiuntivo. Se questa directory si trova nella struttura di directory della pipeline, deve essere denominata AddIns.	UpdateAddIns Aggiornamenti il file con nuovi componenti aggiuntivi in un percorso specificato. Chiamare questo metodo se i componenti aggiuntivi si trovano all'esterno della struttura della directory della pipeline. Se non sono installati nuovi componenti aggiuntivi, questo metodo convalida solo la cache. RebuildAddIns Ricompila il file e include componenti aggiuntivi in un percorso specificato. Chiamare questo metodo se i componenti aggiuntivi si trovano all'esterno della struttura della directory della pipeline. Update Se i componenti aggiuntivi si trovano nella struttura di directory della pipeline, questo metodo aggiorna il file con nuovi componenti aggiuntivi. Rebuild Se i componenti aggiuntivi si trovano nella struttura di directory della pipeline, questo metodo ricompila il file e include nuovi componenti aggiuntivi.

Questi metodi creano i file della cache se non esistono in precedenza.

Dopo aver creato i file della cache, usare il FindAddIns metodo per esaminare i file per trovare tutti i componenti aggiuntivi che corrispondono a una visualizzazione host specificata del componente aggiuntivo. È anche possibile usare il FindAddIn metodo per trovare un componente aggiuntivo specifico.

Importante

Non è supportato per consentire agli utenti o alle entità non attendibili di accedere a PipelineSegments.store e Addins.store. Questa operazione può causare problemi di danneggiamento dei dati per le applicazioni.

Metodi

FindAddIn(Type, String, String, String)	Individua un componente aggiuntivo specifico.
FindAddIns(Type, PipelineStoreLocation)	Individua tutti i componenti aggiuntivi di una determinata visualizzazione host del componente aggiuntivo all'interno del percorso specificato dal valore di enumerazione PipelineStoreLocation.
FindAddIns(Type, PipelineStoreLocation, String[])	Individua tutti i componenti aggiuntivi di una determinata visualizzazione host del componente aggiuntivo all'interno del percorso specificato da un valore PipelineStoreLocation e, facoltativamente, all'interno di una cartella di componenti aggiuntivi.
FindAddIns(Type, String, String[])	Individua tutti i componenti aggiuntivi di una determinata visualizzazione host del componente aggiuntivo contenuti in una directory radice specificata.
Rebuild(PipelineStoreLocation)	Ricompila la cache dei segmenti di pipeline e include i nuovi segmenti contenuti nel percorso specificato da un valore PipelineStoreLocation.
Rebuild(String)	Ricompila la cache dei segmenti di pipeline e include i nuovi segmenti contenuti in una directory radice specificata.
RebuildAddIns(String)	Ricompila la cache dei componenti aggiuntivi e include i nuovi componenti aggiuntivi contenuti in una directory radice specificata.
Update(PipelineStoreLocation)	Aggiorna la cache dei segmenti di pipeline con i nuovi segmenti contenuti nel percorso specificato da un valore PipelineStoreLocation.
Update(String)	Aggiorna la cache dei segmenti di pipeline con i nuovi segmenti contenuti in una directory radice specificata.
UpdateAddIns(String)	Aggiorna la cache dei componenti aggiuntivi e include i nuovi componenti aggiuntivi contenuti in un percorso specificato.

Vedi anche

• Componenti aggiuntivi ed estendibilità