AddInStore.FindAddIn(Type, String, String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Localiza um suplemento específico.
public:
static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIn(Type ^ hostViewOfAddIn, System::String ^ pipelineRootFolderPath, System::String ^ addInFilePath, System::String ^ addInTypeName);
[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIn (Type hostViewOfAddIn, string pipelineRootFolderPath, string addInFilePath, string addInTypeName);
[<System.Security.SecurityCritical>]
static member FindAddIn : Type * string * string * string -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>
Public Shared Function FindAddIn (hostViewOfAddIn As Type, pipelineRootFolderPath As String, addInFilePath As String, addInTypeName As String) As Collection(Of AddInToken)
Parâmetros
- hostViewOfAddIn
- Type
O tipo que define a exibição do suplemento do host.
- pipelineRootFolderPath
- String
O caminho para a raiz da estrutura de diretório do pipeline.
- addInFilePath
- String
O caminho e o nome de arquivo do suplemento a ser localizado.
- addInTypeName
- String
O nome do tipo do suplemento.
Retornos
Uma coleção de tokens que contém apenas o token que representa o suplemento encontrado.
- Atributos
Exceções
O comprimento de pipelineRootFolderPath
, addInFilePath
ou addInTypeName
é zero.
- ou -
O arquivo de suplemento não existe no addInfilePath
.
Um ou mais parâmetros são null
.
O chamador não tem permissão de acesso de leitura ao pipelineRootFolderPath
.
Exemplos
O exemplo a seguir localiza um suplemento específico.
// Find a specific add-in.
// Construct the path to the add-in.
string addInFilePath = pipeRoot + @"\AddIns\P3AddIn2\P3AddIn2.dll";
// The fourth parameter, addinTypeName, takes the full name
// of the type qualified by its namespace. Same as AddInToken.AddInFullName.
Collection<AddInToken> tokenColl = AddInStore.FindAddIn(typeof(Calculator),
pipeRoot, addInFilePath, "CalcAddIns.P3AddIn2");
Console.WriteLine("Found {0}", tokenColl[0].Name);
' Find a specific add-in.
' Construct the path to the add-in.
Dim addInFilePath As String = (pipeRoot + "\AddIns\P3AddIn2\P3AddIn2.dll")
' The fourth parameter, addinTypeName, takes the full name
' of the type qualified by its namespace. Same as AddInToken.AddInFullName.
Dim tokenColl As System.Collections.ObjectModel.Collection(Of AddInToken) = AddInStore.FindAddIn(GetType(Calculator), pipeRoot, addInFilePath, "CalcAddIns.P3AddIn2")
Console.WriteLine("Found {0}", tokenColl(0).Name)
Comentários
Se um único pipeline para um suplemento for encontrado, ele será o único item na AddInToken coleção. Se vários pipelines para o suplemento especificado forem encontrados, você poderá diferenciá-los examinando a QualificationData propriedade .