AddInStore.FindAddIn(Type, String, String, String) Metodo

Definizione

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

Si applica a

Vedi anche