AddInStore.FindAddIns Método

Definição

Localiza todos os suplementos para uma exibição do suplemento do host especificada.Finds all add-ins for a specified host view of the add-in.

Sobrecargas

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.Finds all add-ins for a specified host view of the add-in at a location specified by the PipelineStoreLocation enumeration value.

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.Finds all add-ins for a specified host view of the add-in at the location specified by a PipelineStoreLocation value and an optional add-ins folder.

FindAddIns(Type, String, String[])

Localiza todos os suplementos para uma exibição do suplemento do host especificada de um diretório raiz especificado.Finds all add-ins for a specified host view of the add-in from a specified root directory.

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.Finds all add-ins for a specified host view of the add-in at a location specified by the PipelineStoreLocation enumeration value.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::AddIn::Hosting::PipelineStoreLocation location);
[System.Security.SecurityCritical]
[System.Security.SecurityTreatAsSafe]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns (Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location);
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns (Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location);
[<System.Security.SecurityCritical>]
[<System.Security.SecurityTreatAsSafe>]
static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>
static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>
Public Shared Function FindAddIns (hostViewOfAddIn As Type, location As PipelineStoreLocation) As Collection(Of AddInToken)

Parâmetros

hostViewOfAddIn
Type

O tipo que define a exibição do suplemento do host.The type that defines the host's view of the add-in.

location
PipelineStoreLocation

O diretório da base de aplicativo host.The host application's base directory.

Retornos

Collection<AddInToken>

Uma coleção de tokens que representam os suplementos foram localizados.A collection of tokens that represent the add-ins that were found.

Atributos

Exceções

Há uma violação de acesso para a estrutura de diretórios do pipeline.There is an access violation to the pipeline directory structure.

location é um valor PipelineStoreLocation inválido.location is an invalid PipelineStoreLocation value.

Exemplos

O exemplo a seguir localiza os suplementos no local especificado pela PipelineStoreLocation enumeração.The following example finds add-ins at the location specified by the PipelineStoreLocation enumeration.

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

A PipelineStoreLocation Enumeração atualmente contém apenas o ApplicationBase valor, que aponta para o diretório base do aplicativo do host.The PipelineStoreLocation enumeration currently contains only the ApplicationBase value, which points to the host's application base directory.

Aplica-se a

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.Finds all add-ins for a specified host view of the add-in at the location specified by a PipelineStoreLocation value and an optional add-ins folder.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::AddIn::Hosting::PipelineStoreLocation location, ... cli::array <System::String ^> ^ addInFolderPaths);
[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns (Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location, params string[] addInFolderPaths);
[<System.Security.SecurityCritical>]
static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation * string[] -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>
Public Shared Function FindAddIns (hostViewOfAddIn As Type, location As PipelineStoreLocation, ParamArray addInFolderPaths As String()) As Collection(Of AddInToken)

Parâmetros

hostViewOfAddIn
Type

O tipo que define a exibição do suplemento do host.The type that defines the host's view of the add-in.

location
PipelineStoreLocation

Um dos valores de enumeração.One of the enumeration values.

Atualmente, o único valor nesta enumeração é o diretório especificado pela propriedade ApplicationBase que foi usada para configurar o domínio do aplicativo host.Currently the only value in this enumeration is the directory specified by the ApplicationBase property that was used to set up the host's application domain.

addInFolderPaths
String[]

(Opcional).(Optional). O caminho do diretório que contém um ou mais subdiretórios de suplementos. Como esse parâmetro usa uma matriz de cadeias de caracteres, você pode especificar mais de um caminho.The path of the directory that contains one or more subdirectories of add-ins. Because this parameter takes an array of strings, you can specify more than one path.

Esse parâmetro não é necessário se os suplementos estão localizados na estrutura de diretório de pipeline na pasta AddIns.This parameter is not required if your add-ins are located in the pipeline directory structure under the AddIns folder.

Retornos

Collection<AddInToken>

Uma coleção de tokens que representam os suplementos foram localizados.A collection of tokens that represent the add-ins that were found.

Atributos

Exceções

Há uma violação de acesso para a estrutura de diretórios do pipeline.There is an access violation to the pipeline directory structure.

location é um valor PipelineStoreLocation inválido.location is an invalid PipelineStoreLocation value.

Comentários

Use essa sobrecarga de método para habilitar um host parcialmente confiável, que pode não ter a permissão de descoberta de caminho para descobrir seu próprio local, para localizar suplementos em seu próprio diretório.Use this method overload to enable a partially trusted host, which may not have path discovery permission to discover its own location, to find add-ins in its own directory.

Aplica-se a

FindAddIns(Type, String, String[])

Localiza todos os suplementos para uma exibição do suplemento do host especificada de um diretório raiz especificado.Finds all add-ins for a specified host view of the add-in from a specified root directory.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::String ^ pipelineRootFolderPath, ... cli::array <System::String ^> ^ addInFolderPaths);
[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns (Type hostViewOfAddIn, string pipelineRootFolderPath, params string[] addInFolderPaths);
[<System.Security.SecurityCritical>]
static member FindAddIns : Type * string * string[] -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>
Public Shared Function FindAddIns (hostViewOfAddIn As Type, pipelineRootFolderPath As String, ParamArray addInFolderPaths As String()) As Collection(Of AddInToken)

Parâmetros

hostViewOfAddIn
Type

O tipo que define a exibição do suplemento do host.The type that defines the host's view of the add-in.

pipelineRootFolderPath
String

O caminho da raiz da estrutura de diretório do pipeline.The path of the root of the pipeline directory structure.

addInFolderPaths
String[]

(Opcional).(Optional). O caminho do diretório que contém um ou mais subdiretórios de suplementos. Como esse parâmetro usa uma matriz de cadeias de caracteres, você pode especificar mais de um caminho.The path of the directory that contains one or more subdirectories of add-ins. Because this parameter takes an array of strings, you can specify more than one path.

Esse parâmetro não é necessário se os suplementos estão localizados na estrutura de diretório de pipeline na pasta AddIns.This parameter is not required if your add-ins are located in the pipeline directory structure under the AddIns folder.

Retornos

Collection<AddInToken>

Uma coleção de tokens que representam os suplementos foram localizados.A collection of tokens that represent the add-ins that were found.

Atributos

Exceções

Há uma violação de acesso para a estrutura de diretórios do pipeline.There is an access violation to the pipeline directory structure.

Comentários

Esse método examina os arquivos de armazenamento do suplemento armazenado em cache e as informações de segmento de pipeline para localizar todos os suplementos que correspondem a um hostAddInView tipo especificado.This method examines the store files of cached add-in and pipeline segment information to find all add-ins that match a specified hostAddInView type. Você pode usar um dos tokens na AddInToken coleção retornada para ativar um suplemento específico chamando o Activate método da AddInToken classe.You can then use one of the tokens in the returned AddInToken collection to activate a specific add-in by calling the Activate method of the AddInToken class.

Confira também

Aplica-se a