AddInStore.FindAddIn(Type, String, String, String) メソッド

定義

名前空間:

System.AddIn.Hosting

アセンブリ:

System.AddIn.dll

特定のアドインを検索します。

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)

パラメーター

hostViewOfAddIn

Type

ホストのアドイン ビューを定義する型。

pipelineRootFolderPath

String

パイプライン ディレクトリ構造のルート パス。

addInFilePath

String

検索するアドインのパスとファイル名。

addInTypeName

String

アドインの型の名前。

戻り値

Collection<AddInToken>

トークンのコレクション。見つかったアドインを表すトークンのみが格納されています。

属性

SecurityCriticalAttribute

例外

ArgumentException

pipelineRootFolderPath、addInFilePath、または addInTypeName の長さが 0 です。

- または -

このアドイン ファイルは addInfilePath に存在しません。

ArgumentNullException

1 つ以上のパラメーターが null です。

SecurityException

呼び出し元に、pipelineRootFolderPath への読み取りアクセス許可がありません。

例

次の例では、特定のアドインを検索します。

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

注釈

アドインの 1 つのパイプラインが見つかった場合は、コレクション内の唯一の AddInToken 項目になります。 指定したアドインへの複数のパイプラインが見つかった場合は、 プロパティを QualificationData 調べることで区別できます。

こちらもご覧ください

• FindAddIns(Type, String, String[])