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

  • Riferimento

Definizione

Spazio dei nomi:
System.AddIn.Hosting
Assembly:
System.AddIn.dll

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

Collection<AddInToken>

Insieme di token contenente soltanto il token che rappresenta il componente aggiuntivo individuato.

Attributi
SecurityCriticalAttribute

Eccezioni

ArgumentException

La lunghezza di pipelineRootFolderPath, addInFilePath o addInTypeName è 0.

-oppure-

Il file di componente aggiuntivo non esiste in addInfilePath.

ArgumentNullException

Uno o più parametri sono null.

SecurityException

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