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

Definition

Sucht ein bestimmtes Add-In.

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)

Parameter

hostViewOfAddIn
Type

Der Typ, der die Hostansicht des Add-Ins definiert.

pipelineRootFolderPath
String

Der Pfad zum Stamm der Pipelineverzeichnisstruktur.

addInFilePath
String

Der Pfad und Dateiname des zu suchenden Add-Ins.

addInTypeName
String

Der Typname des Add-Ins.

Gibt zurück

Eine Auflistung von Token, die nur das Token enthält, das das gefundene Add-In darstellt.

Attribute

Ausnahmen

Die Länge von pipelineRootFolderPath, addInFilePath oder addInTypeName ist 0.

- oder -

Die Add-In-Datei ist in addInfilePath nicht vorhanden.

Mindestens ein Parameter ist null.

Der Aufrufer besitzt keine Lesezugriffsberechtigung für pipelineRootFolderPath.

Beispiele

Im folgenden Beispiel wird ein bestimmtes Add-In gefunden.

// 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)

Hinweise

Wenn eine einzelne Pipeline für ein Add-In gefunden wird, ist es das einzige Element in der AddInToken Auflistung. Wenn mehrere Pipelines zum angegebenen Add-In gefunden werden, können Sie diese unterscheiden, indem Sie die QualificationData -Eigenschaft untersuchen.

Gilt für:

Weitere Informationen