AddInStore.FindAddIn(Type, String, String, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Individua un componente aggiuntivo specifico.
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)
Parametri
- hostViewOfAddIn
- Type
Tipo che definisce la visualizzazione host del componente aggiuntivo.
- pipelineRootFolderPath
- String
Percorso radice della struttura di directory della pipeline.
- addInFilePath
- String
Percorso e nome di file del componente aggiuntivo da individuare.
- addInTypeName
- String
Nome del tipo del componente aggiuntivo.
Restituisce
Insieme di token contenente soltanto il token che rappresenta il componente aggiuntivo individuato.
- Attributi
Eccezioni
La lunghezza di pipelineRootFolderPath
, addInFilePath
o addInTypeName
è 0.
-oppure-
Il file di componente aggiuntivo non esiste in addInfilePath
.
Uno o più parametri sono null
.
Il chiamante non dispone dell'autorizzazione di accesso in lettura a pipelineRootFolderPath
.
Esempio
Nell'esempio seguente viene trovato un componente aggiuntivo specifico.
// 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)
Commenti
Se viene trovata una singola pipeline per un componente aggiuntivo, sarà l'unico elemento della AddInToken raccolta. Se vengono trovate più pipeline nel componente aggiuntivo specificato, è possibile differenziarle esaminando la QualificationData proprietà.