AddInStore Класс

Определение

Предоставляет методы хранения и поиска информации о доступных надстройках и сегментах конвейера.Provides methods to store and find information about available add-ins and pipeline segments.

public ref class AddInStore abstract sealed
public static class AddInStore
type AddInStore = class
Public Class AddInStore
Наследование
AddInStore

Примеры

В следующем примере показано, как обновить файлы кэша.The following example shows how to update cache files.

// Get path for the pipeline root.
// Assumes that the current directory is the  
// pipeline directory structure root directory. 
String pipeRoot = Environment.CurrentDirectory;

// Update the cache files of the
// pipeline segments and add-ins.
string[] warnings = AddInStore.Update(pipeRoot);

foreach (string warning in warnings)
{
    Console.WriteLine(warning);
}

// 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);
' Get the path for the pipeline root.  
' Assumes that the current directory is the
' pipline directory structure root directory.
Dim pipeRoot As String = Environment.CurrentDirectory
' Update the cache files of the
' pipeline segments and add-ins.
Dim warnings() As String = AddInStore.Update(pipeRoot)
For Each warning As String In warnings
    Console.WriteLine(warning)
Next

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

Комментарии

Этот класс используется для сборки, перестроения и обновления двух файлов кэша, как описано в следующей таблице.Use this class to build, rebuild, and update two cache files, as described in the following table.

Файл кэшаCache file Методы, создающие файлMethods that create the file
Пипелинесегментс. StorePipelineSegments.store

Этот файл находится в корневом каталоге структуры каталогов конвейера.This file is located in the root directory of the pipeline directory structure.
Update

Обновляет файл новыми сегментами конвейера.Updates the file with new pipeline segments. Если новые сегменты не установлены, этот метод просто проверяет кэш.If no new segments are installed, this method just validates the cache.

Rebuild

Перестраивает файл и включает новые сегменты конвейера.Rebuilds the file and includes new pipeline segments.
Надстройки. StoreAddIns.store

Этот файл находится в каталоге, содержащем один или несколько подкаталогов надстройки.This file is located in a directory that contains one or more add-in subdirectories. Если этот каталог находится в структуре каталогов конвейера, он должен иметь имя AddIn.If this directory is in the pipeline directory structure, it must be named AddIns.
UpdateAddIns

Обновляет файл новыми надстройками в указанном расположении.Updates the file with new add-ins at a specified location. Этот метод следует вызывать, если надстройки находятся за пределами структуры каталогов конвейера.Call this method if your add-ins are outside the pipeline directory structure.

Если новые надстройки не установлены, этот метод просто проверяет кэш.If no new add-ins are installed, this method just validates the cache.

RebuildAddIns

Перестраивает файл и включает надстройки в указанном расположении.Rebuilds the file and includes add-ins at a specified location. Этот метод следует вызывать, если надстройки находятся за пределами структуры каталогов конвейера.Call this method if your add-ins are outside the pipeline directory structure.

Update

Если надстройки находятся в структуре каталогов конвейера, этот метод обновляет файл новыми надстройками.If the add-ins are in the pipeline directory structure, this method updates the file with new add-ins.

Rebuild

Если надстройки находятся в структуре каталогов конвейера, этот метод перестраивает файл и включает в себя новые надстройки.If the add-ins are in the pipeline directory structure, this method rebuilds the file and includes new add-ins.

Эти методы создают файлы кэша, если они не существовали ранее.These methods create the cache files if they do not previously exist.

После создания файлов кэша используйте FindAddIns метод, чтобы проверить файлы, чтобы найти все надстройки, соответствующие указанному хост-представлению надстройки.After the cache files are created, use the FindAddIns method to examine the files to find all add-ins that match a specified host view of the add-in. Для поиска конкретной надстройки FindAddIn можно также использовать метод.You can also use the FindAddIn method to find a specific add-in.

Важно!

Недоверенные пользователи или сущности не поддерживают доступ к Пипелинесегментс. Store и надстройкам. Store.It is unsupported to allow untrusted users or entities to access PipelineSegments.store and Addins.store. Это может вызвать проблемы с повреждением данных в приложениях.Doing so can cause data corruption issues for applications.

Методы

FindAddIn(Type, String, String, String)

Находит конкретную надстройку.Finds a specific 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.

Rebuild(PipelineStoreLocation)

Перестраивает кэш сегментов конвейера и включает новые сегменты в месте, указанном значением PipelineStoreLocation.Rebuilds the pipeline segments cache and includes new segments at the location specified by a PipelineStoreLocation value.

Rebuild(String)

Перестраивает кэш сегментов конвейера и включает новые сегменты из указанного корневого каталога.Rebuilds the pipeline segments cache and includes new segments from a specified root directory.

RebuildAddIns(String)

Перестраивает кэш надстройки и включает новые надстройки из указанного корневого каталога.Rebuilds the add-in cache and includes new add-ins from a specified root directory.

Update(PipelineStoreLocation)

Обновляет кэш сегментов конвейера новыми сегментами в месте, указанном значением PipelineStoreLocation.Updates the pipeline segments cache with new segments at the location specified by a PipelineStoreLocation value.

Update(String)

Обновляет кэш сегментов конвейера новыми сегментами из указанного корневого каталога.Updates the pipeline segments cache with new segments from a specified root directory.

UpdateAddIns(String)

Обновляет кэш надстройки и включает новые надстройки из указанного места.Updates the add-in cache and includes new add-ins at a specified location.

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

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