AddInStore.FindAddIns メソッド

定義

指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in.

オーバーロード

FindAddIns(Type, PipelineStoreLocation)

PipelineStoreLocation 列挙値によって指定された位置にある指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in at a location specified by the PipelineStoreLocation enumeration value.

FindAddIns(Type, PipelineStoreLocation, String[])

PipelineStoreLocation 値およびアドイン フォルダー (省略可能) によって指定された位置にある指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in at the location specified by a PipelineStoreLocation value and an optional add-ins folder.

FindAddIns(Type, String, String[])

指定したルート ディレクトリの指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in from a specified root directory.

FindAddIns(Type, PipelineStoreLocation)

PipelineStoreLocation 列挙値によって指定された位置にある指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in at a location specified by the PipelineStoreLocation enumeration value.

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

パラメーター

hostViewOfAddIn
Type

ホストのアドイン ビューを定義する型。The type that defines the host's view of the add-in.

location
PipelineStoreLocation

ホスト アプリケーションのベース ディレクトリ。The host application's base directory.

戻り値

見つかったアドインを表すトークンのコレクション。A collection of tokens that represent the add-ins that were found.

属性

例外

パイプライン ディレクトリ構造に対するアクセス違反があります。There is an access violation to the pipeline directory structure.

location は無効な PipelineStoreLocation 値です。location is an invalid PipelineStoreLocation value.

次の例では、PipelineStoreLocation 列挙体によって指定された位置にあるアドインを検索します。The following example finds add-ins at the location specified by the PipelineStoreLocation enumeration.

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

注釈

現在、PipelineStoreLocation 列挙には、ホストのアプリケーションベースディレクトリを指す ApplicationBase 値のみが含まれています。The PipelineStoreLocation enumeration currently contains only the ApplicationBase value, which points to the host's application base directory.

FindAddIns(Type, PipelineStoreLocation, String[])

PipelineStoreLocation 値およびアドイン フォルダー (省略可能) によって指定された位置にある指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in at the location specified by a PipelineStoreLocation value and an optional add-ins folder.

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

パラメーター

hostViewOfAddIn
Type

ホストのアドイン ビューを定義する型。The type that defines the host's view of the add-in.

location
PipelineStoreLocation

列挙値の 1 つ。One of the enumeration values.

現在この列挙値の唯一の値は、ホストのアプリケーション ドメインを設定するために使用された ApplicationBase プロパティで指定されるディレクトリです。Currently the only value in this enumeration is the directory specified by the ApplicationBase property that was used to set up the host's application domain.

addInFolderPaths
String[]

(省略可能)(Optional). アドインのサブディレクトリが 1 つ以上含まれるディレクトリのパス。このパラメーターは文字列配列であるため、複数のパスを指定できます。The path of the directory that contains one or more subdirectories of add-ins. Because this parameter takes an array of strings, you can specify more than one path.

アドインが AddIns フォルダーの下のパイプライン ディレクトリ構造内にある場合、このパラメーターは必要ありません。This parameter is not required if your add-ins are located in the pipeline directory structure under the AddIns folder.

戻り値

見つかったアドインを表すトークンのコレクション。A collection of tokens that represent the add-ins that were found.

属性

例外

パイプライン ディレクトリ構造に対するアクセス違反があります。There is an access violation to the pipeline directory structure.

location は無効な PipelineStoreLocation 値です。location is an invalid PipelineStoreLocation value.

注釈

このメソッドオーバーロードを使用して、部分的に信頼されたホストを有効にします。これは、独自の場所を検出するためのパス検出アクセス許可がない可能性があり、独自のディレクトリ内のアドインを検索します。Use this method overload to enable a partially trusted host, which may not have path discovery permission to discover its own location, to find add-ins in its own directory.

FindAddIns(Type, String, String[])

指定したルート ディレクトリの指定したアドインのホスト ビューを対象に、すべてのアドインを検索します。Finds all add-ins for a specified host view of the add-in from a specified root directory.

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

パラメーター

hostViewOfAddIn
Type

ホストのアドイン ビューを定義する型。The type that defines the host's view of the add-in.

pipelineRootFolderPath
String

パイプライン ディレクトリ構造のルート パス。The path of the root of the pipeline directory structure.

addInFolderPaths
String[]

(省略可能)(Optional). アドインのサブディレクトリが 1 つ以上含まれるディレクトリのパス。このパラメーターは文字列配列であるため、複数のパスを指定できます。The path of the directory that contains one or more subdirectories of add-ins. Because this parameter takes an array of strings, you can specify more than one path.

アドインが AddIns フォルダーの下のパイプライン ディレクトリ構造内にある場合、このパラメーターは必要ありません。This parameter is not required if your add-ins are located in the pipeline directory structure under the AddIns folder.

戻り値

見つかったアドインを表すトークンのコレクション。A collection of tokens that represent the add-ins that were found.

属性

例外

パイプライン ディレクトリ構造に対するアクセス違反があります。There is an access violation to the pipeline directory structure.

注釈

このメソッドは、キャッシュされたアドインとパイプラインセグメント情報のストアファイルを調べて、指定した hostAddInView の種類に一致するすべてのアドインを検索します。This method examines the store files of cached add-in and pipeline segment information to find all add-ins that match a specified hostAddInView type. 次に、返された AddInToken コレクション内のいずれかのトークンを使用して、AddInToken クラスの Activate メソッドを呼び出すことにより、特定のアドインをアクティブ化できます。You can then use one of the tokens in the returned AddInToken collection to activate a specific add-in by calling the Activate method of the AddInToken class.

こちらもご覧ください

適用対象