AddInStore Classe

Definição

Namespace:

System.AddIn.Hosting

Assembly:

System.AddIn.dll

Fornece métodos para armazenar e localizar informações sobre suplementos 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 a seguir mostra como atualizar arquivos 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)

Comentários

Use essa classe para compilar, recompilar e atualizar dois arquivos de cache, conforme descrito na tabela a seguir.

Arquivo de cache	Métodos que criam o arquivo
PipelineSegments.store Esse arquivo está localizado no diretório raiz da estrutura do diretório do pipeline.	Update Atualizações o arquivo com novos segmentos de pipeline. Se nenhum novo segmento estiver instalado, esse método apenas validará o cache. Rebuild Recria o arquivo e inclui novos segmentos de pipeline.
AddIns.store Esse arquivo está localizado em um diretório que contém um ou mais subdiretórios de suplementos. Se esse diretório estiver na estrutura do diretório do pipeline, ele deverá ser nomeado AddIns.	UpdateAddIns Atualizações o arquivo com novos suplementos em um local especificado. Chame esse método se os suplementos estiverem fora da estrutura do diretório do pipeline. Se nenhum novo suplemento estiver instalado, esse método apenas validará o cache. RebuildAddIns Recria o arquivo e inclui suplementos em um local especificado. Chame esse método se os suplementos estiverem fora da estrutura do diretório do pipeline. Update Se os suplementos estiverem na estrutura do diretório do pipeline, esse método atualizará o arquivo com novos suplementos. Rebuild Se os suplementos estiverem na estrutura do diretório do pipeline, esse método recriará o arquivo e incluirá novos suplementos.

Esses métodos criarão os arquivos de cache se eles não existirem anteriormente.

Depois que os arquivos de cache forem criados, use o FindAddIns método para examinar os arquivos para localizar todos os suplementos que correspondem a uma exibição de host especificada do suplemento. Você também pode usar o FindAddIn método para localizar um suplemento específico.

Importante

Não há suporte para permitir que usuários ou entidades não confiáveis acessem PipelineSegments.store e Addins.store. Isso pode causar problemas de corrupção de dados para aplicativos.

Métodos

FindAddIn(Type, String, String, String)	Localiza um suplemento específico.
FindAddIns(Type, PipelineStoreLocation)	Localiza todos os suplementos para uma exibição do suplemento do host especificada em um local especificado pelo valor de enumeração PipelineStoreLocation.
FindAddIns(Type, PipelineStoreLocation, String[])	Localiza todos os suplementos para uma exibição do suplemento do host no local especificado por um valor PipelineStoreLocation e uma pasta de suplementos adicional.
FindAddIns(Type, String, String[])	Localiza todos os suplementos para uma exibição do suplemento do host especificada de um diretório raiz especificado.
Rebuild(PipelineStoreLocation)	Recria o cache de segmentos de pipeline e inclui novos segmentos no local especificado por um valor PipelineStoreLocation.
Rebuild(String)	Recria o cache de segmentos de pipeline e inclui novos segmentos de um diretório raiz especificado.
RebuildAddIns(String)	Recria o cache de suplemento e inclui novos suplementos de um diretório raiz especificado.
Update(PipelineStoreLocation)	Atualiza o cache de segmentos de pipeline com novos segmentos no local especificado por um valor PipelineStoreLocation.
Update(String)	Atualiza o cache de segmentos de pipeline com novos segmentos de um diretório raiz especificado.
UpdateAddIns(String)	Atualiza o cache de suplemento e inclui novos suplementos no local especificado.

Confira também

• Suplementos e extensibilidade