AddInStore.FindAddIn(Type, String, String, String) Метод

Определение

Находит конкретную надстройку.

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

Имя типа надстройки.

Возвращаемое значение

Коллекция токенов, содержащая только токены, представляющие найденные надстройки.

Атрибуты

Исключения

Длина pipelineRootFolderPath или addInFilePath, или addInTypeName равна 0.

-или-

Файл надстройки в addInfilePath не существует.

Один или несколько параметров имеют значение null.

Вызывающий оператор не имеет разрешения на чтение 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)

Комментарии

Если найден один конвейер для надстройки, он будет единственным элементом AddInToken в коллекции. Если обнаружено несколько конвейеров для указанной надстройки, их можно отличить, изучив QualificationData свойство .

Применяется к

См. также раздел