AddInStore.FindAddIns Methode

Definition

Namespace:: System.AddIn.Hosting

Assembly:: System.AddIn.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins.

Überlädt

Name	Beschreibung
FindAddIns(Type, PipelineStoreLocation)	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an einem Speicherort, der durch den PipelineStoreLocation Enumerationswert angegeben wird.
FindAddIns(Type, PipelineStoreLocation, String[])	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an dem Speicherort, der durch einen PipelineStoreLocation Wert und einen optionalen Add-Ins-Ordner angegeben wird.
FindAddIns(Type, String, String[])	Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins aus einem angegebenen Stammverzeichnis.

FindAddIns(Type, PipelineStoreLocation)

Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an einem Speicherort, der durch den PipelineStoreLocation Enumerationswert angegeben wird.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::AddIn::Hosting::PipelineStoreLocation location);

[System.Security.SecurityCritical]
[System.Security.SecurityTreatAsSafe]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns(Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location);

public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns(Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location);

[<System.Security.SecurityCritical>]
[<System.Security.SecurityTreatAsSafe>]
static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>

static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>

Public Shared Function FindAddIns (hostViewOfAddIn As Type, location As PipelineStoreLocation) As Collection(Of AddInToken)

Parameter

hostViewOfAddIn: Type

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

location: PipelineStoreLocation

Das Basisverzeichnis der Hostanwendung.

Gibt zurück

Collection<AddInToken>

Eine Sammlung von Token, die die gefundenen Add-Ins darstellen.

Attribute: SecurityCriticalAttribute SecurityTreatAsSafeAttribute

Ausnahmen

InvalidPipelineStoreException

Es liegt ein Zugriffsverstoß gegen die Pipelineverzeichnisstruktur vor.

ArgumentException

location ist ein ungültiger PipelineStoreLocation Wert.

Beispiele

Im folgenden Beispiel werden Add-Ins an der durch die PipelineStoreLocation Enumeration angegebenen Position gefunden.

// Search for add-ins of type Calculator (the host view of the add-in)
// specifying the host's application base, instead of a path,
// for the FindAddIns method.

Collection<AddInToken> tokens =
            AddInStore.FindAddIns(typeof(Calculator), PipelineStoreLocation.ApplicationBase);

' Search for add-ins of type Calculator (the host view of the add-in)
' specifying the host's application base, instead of a path,
' for the FindAddIns method.
Dim tokens As Collection(Of AddInToken) =
    AddInStore.FindAddIns(GetType(Calculator), PipelineStoreLocation.ApplicationBase)

Hinweise

Die PipelineStoreLocation Enumeration enthält derzeit nur den ApplicationBase Wert, der auf das Anwendungsbasisverzeichnis des Hosts verweist.

Gilt für:

FindAddIns(Type, PipelineStoreLocation, String[])

Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins an dem Speicherort, der durch einen PipelineStoreLocation Wert und einen optionalen Add-Ins-Ordner angegeben wird.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::AddIn::Hosting::PipelineStoreLocation location, ... cli::array <System::String ^> ^ addInFolderPaths);

[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns(Type hostViewOfAddIn, System.AddIn.Hosting.PipelineStoreLocation location, params string[] addInFolderPaths);

[<System.Security.SecurityCritical>]
static member FindAddIns : Type * System.AddIn.Hosting.PipelineStoreLocation * string[] -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>

Public Shared Function FindAddIns (hostViewOfAddIn As Type, location As PipelineStoreLocation, ParamArray addInFolderPaths As String()) As Collection(Of AddInToken)

Parameter

hostViewOfAddIn: Type

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

location: PipelineStoreLocation

Einer der Enumerationswerte.

Derzeit ist der einzige Wert in dieser Enumeration das Verzeichnis, das von der ApplicationBase Eigenschaft angegeben wurde, die zum Einrichten der Anwendungsdomäne des Hosts verwendet wurde.

addInFolderPaths: String[]

(optional) Der Pfad des Verzeichnisses, das ein oder mehrere Unterverzeichnisse von Add-Ins enthält. Da dieser Parameter ein Array von Zeichenfolgen verwendet, können Sie mehrere Pfade angeben.

Dieser Parameter ist nicht erforderlich, wenn sich Ihre Add-Ins in der Pipelineverzeichnisstruktur unter dem Ordner "AddIns" befinden.

Gibt zurück

Collection<AddInToken>

Eine Sammlung von Token, die die gefundenen Add-Ins darstellen.

Attribute: SecurityCriticalAttribute

Ausnahmen

InvalidPipelineStoreException

Es liegt ein Zugriffsverstoß gegen die Pipelineverzeichnisstruktur vor.

ArgumentException

location ist ein ungültiger PipelineStoreLocation Wert.

Hinweise

Verwenden Sie diese Methodenüberladung, um einen teilweise vertrauenswürdigen Host zu aktivieren, der möglicherweise keine Pfadermittlungsberechtigung zum Ermitteln seines eigenen Speicherorts hat, um Add-Ins in seinem eigenen Verzeichnis zu finden.

Gilt für:

FindAddIns(Type, String, String[])

Sucht alle Add-Ins für eine angegebene Hostansicht des Add-Ins aus einem angegebenen Stammverzeichnis.

public:
 static System::Collections::ObjectModel::Collection<System::AddIn::Hosting::AddInToken ^> ^ FindAddIns(Type ^ hostViewOfAddIn, System::String ^ pipelineRootFolderPath, ... cli::array <System::String ^> ^ addInFolderPaths);

[System.Security.SecurityCritical]
public static System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken> FindAddIns(Type hostViewOfAddIn, string pipelineRootFolderPath, params string[] addInFolderPaths);

[<System.Security.SecurityCritical>]
static member FindAddIns : Type * string * string[] -> System.Collections.ObjectModel.Collection<System.AddIn.Hosting.AddInToken>

Public Shared Function FindAddIns (hostViewOfAddIn As Type, pipelineRootFolderPath As String, ParamArray addInFolderPaths As String()) As Collection(Of AddInToken)

Parameter

hostViewOfAddIn: Type

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

pipelineRootFolderPath: String

Der Pfad des Stamms der Pipelineverzeichnisstruktur.

addInFolderPaths: String[]

(optional) Der Pfad des Verzeichnisses, das ein oder mehrere Unterverzeichnisse von Add-Ins enthält. Da dieser Parameter ein Array von Zeichenfolgen verwendet, können Sie mehrere Pfade angeben.

Dieser Parameter ist nicht erforderlich, wenn sich Ihre Add-Ins in der Pipelineverzeichnisstruktur unter dem Ordner "AddIns" befinden.

Gibt zurück

Collection<AddInToken>

Eine Sammlung von Token, die die gefundenen Add-Ins darstellen.

Attribute: SecurityCriticalAttribute

Ausnahmen

InvalidPipelineStoreException

Es liegt ein Zugriffsverstoß gegen die Pipelineverzeichnisstruktur vor.

Hinweise

Diese Methode untersucht die Speicherdateien von zwischengespeicherten Add-Ins und Pipelinesegmentinformationen, um alle Add-Ins zu finden, die einem angegebenen hostAddInView Typ entsprechen. Sie können dann eines der Token in der zurückgegebenen AddInToken Sammlung verwenden, um ein bestimmtes Add-In zu aktivieren, indem Sie die Activate Methode der AddInToken Klasse aufrufen.

Weitere Informationen

FindAddIn(Type, String, String, String)

Gilt für:

Feedback

War diese Seite hilfreich?