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
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
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
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.