AddInStore.FindAddIn(Type, String, String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Encontra um complemento 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 visão do anfitrião sobre o complemento.
- pipelineRootFolderPath
- String
O caminho até à raiz da estrutura de diretórios do pipeline.
- addInFilePath
- String
O caminho e o nome do ficheiro do add-in a encontrar.
- addInTypeName
- String
O nome do tipo do complemento.
Devoluções
Uma coleção de tokens que contém apenas o token que representa o add-in que foi encontrado.
- Atributos
Exceções
O comprimento de pipelineRootFolderPath ou addInFilePath ou addInTypeName é 0.
-ou-
O ficheiro adicional não existe em addInFilePath.
Um ou mais parâmetros são null.
O chamador não tem permissão de acesso de leitura a pipelineRootFolderPath.
Exemplos
O exemplo seguinte encontra um complemento 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)
Observações
Se for encontrado um único pipeline para um complemento, será o único item na AddInToken coleção. Se forem encontrados múltiplos pipelines para o add-in especificado, pode diferenciá-los examinando a QualificationData propriedade.
