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

Одно из значений перечисления.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). Путь каталога, содержащего один или более подкаталогов надстроек. Поскольку этот параметр занимает массив строк, можно указывать более одного пути.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). Путь каталога, содержащего один или более подкаталогов надстроек. Поскольку этот параметр занимает массив строк, можно указывать более одного пути.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 коллекции для активации конкретной надстройки, Activate вызвав метод AddInToken класса.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.

Дополнительно

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