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

Один или несколько параметров имеют значение 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)

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

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

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

FindAddIns(Type, String, String[])

Поделиться через