AddInStore Classe

Definição

Espaço de Nomes:
System.AddIn.Hosting
Assemblagem:
System.AddIn.dll

Fornece métodos para armazenar e encontrar informação sobre os complementos disponíveis e segmentos de pipeline.

public ref class AddInStore abstract sealed
public static class AddInStore
type AddInStore = class
Public Class AddInStore
Herança
Object
AddInStore

Exemplos

O exemplo seguinte mostra como atualizar ficheiros 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)

Observações

Use esta classe para construir, reconstruir e atualizar dois ficheiros de cache, conforme descrito na tabela seguinte.

Ficheiro de cache Métodos que criam o ficheiro
PipelineSegments.store

Este ficheiro está localizado no diretório raiz da estrutura de diretórios do pipeline.		 Update

Atualiza o ficheiro com novos segmentos de pipeline. Se não houver novos segmentos instalados, este método apenas valida a cache.

Rebuild

Reconstrói o ficheiro e inclui novos segmentos de pipeline.
AddIns.store

Este ficheiro está localizado num diretório que contém um ou mais subdiretórios adicionais. Se este diretório estiver na estrutura de diretórios do pipeline, deve ser chamado AddIns.		 UpdateAddIns

Atualiza o ficheiro com novos complementos numa localização especificada. Chame a este método se os seus add-ins estiverem fora da estrutura de diretórios do pipeline.

Se não forem instalados novos complementos, este método apenas valida a cache.

RebuildAddIns

Reconstrói o ficheiro e inclui complementos numa localização especificada. Chame a este método se os seus add-ins estiverem fora da estrutura de diretórios do pipeline.

Update

Se os add-ins estiverem na estrutura de diretórios do pipeline, este método atualiza o ficheiro com novos add-ins.

Rebuild

Se os add-ins estiverem na estrutura de diretórios do pipeline, este método reconstrói o ficheiro e inclui novos add-ins.

Estes métodos criam os ficheiros de cache caso estes não existam anteriormente.

Depois de criados os ficheiros de cache, utilize o FindAddIns método para examinar os ficheiros e encontrar todos os add-ins que correspondam a uma vista de host especificada do add-in. Também podes usar o FindAddIn método para encontrar um complemento específico.

Importante

Não é suportado para permitir que utilizadores ou entidades não confiáveis acedam a PipelineSegments.store e Addins.store. Fazer isso pode causar problemas de corrupção de dados nas aplicações.

Métodos

Name Description
FindAddIn(Type, String, String, String)

Encontra um complemento específico.
FindAddIns(Type, PipelineStoreLocation, String[])

Encontra todos os add-ins para uma visualização anfitriã especificada do add-in na localização especificada por um PipelineStoreLocation valor e numa pasta opcional de add-ins.
FindAddIns(Type, PipelineStoreLocation)

Encontra todos os complementos para uma visualização anfitriã especificada do complemento numa localização especificada pelo PipelineStoreLocation valor da enumeração.
FindAddIns(Type, String, String[])

Encontra todos os add-ins para uma vista de host especificada do add-in a partir de um diretório raiz especificado.
Rebuild(PipelineStoreLocation)

Reconstrói a cache dos segmentos do pipeline e inclui novos segmentos na localização especificada por um PipelineStoreLocation valor.
Rebuild(String)

Reconstrói a cache dos segmentos do pipeline e inclui novos segmentos a partir de um diretório raiz especificado.
RebuildAddIns(String)

Reconstrói a cache do add-in e inclui novos add-ins a partir de um diretório raiz especificado.
Update(PipelineStoreLocation)

Atualiza a cache dos segmentos do pipeline com novos segmentos na localização especificada por um PipelineStoreLocation valor.
Update(String)

Atualiza a cache dos segmentos do pipeline com novos segmentos a partir de um diretório raiz especificado.
UpdateAddIns(String)

Atualiza a cache dos add-ins e inclui novos add-ins numa localização especificada.

Aplica-se a

Ver também