AddInStore 类

定义

命名空间:

System.AddIn.Hosting

程序集:

System.AddIn.dll

提供方法以存储和查找有关可用外接程序及管线段的信息。

public ref class AddInStore abstract sealed

public static class AddInStore

type AddInStore = class

Public Class AddInStore

继承

Object

AddInStore

示例

以下示例演示如何更新缓存文件。

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

注解

使用此类生成、重新生成和更新两个缓存文件，如下表所述。

缓存文件	创建文件的方法
PipelineSegments.store 此文件位于管道目录结构的根目录中。	Update 使用新的管道段汇报文件。 如果未安装任何新段，则此方法仅验证缓存。 Rebuild 重新生成文件并包括新的管道段。
AddIns.store 此文件位于包含一个或多个外接程序子目录的目录中。 如果此目录位于管道目录结构中，则必须将其命名为 AddIns。	UpdateAddIns 在指定位置汇报包含新外接程序的文件。 如果外接程序位于管道目录结构之外，请调用此方法。 如果未安装任何新加载项，则此方法仅验证缓存。 RebuildAddIns 重新生成文件，并在指定位置包含加载项。 如果外接程序位于管道目录结构之外，请调用此方法。 Update 如果外接程序位于管道目录结构中，则此方法使用新加载项更新文件。 Rebuild 如果外接程序位于管道目录结构中，则此方法将重新生成文件并包含新的外接程序。

如果缓存文件以前不存在，则这些方法会创建这些文件。

创建缓存文件后，使用 FindAddIns 方法检查文件以查找与外接程序的指定主机视图匹配的所有加载项。 还可以使用 FindAddIn 方法查找特定外接程序。

重要

不支持允许不受信任的用户或实体访问 PipelineSegments.store 和 Addins.store。 这样做可能会导致应用程序出现数据损坏问题。

方法

FindAddIn(Type, String, String, String)	查找特定的外接程序。
FindAddIns(Type, PipelineStoreLocation)	在由 PipelineStoreLocation 枚举值指定的位置查找外接程序的指定宿主视图的所有外接程序。
FindAddIns(Type, PipelineStoreLocation, String[])	在由 PipelineStoreLocation 值指定的位置和可选外接程序文件夹中查找外接程序的指定宿主视图的所有外接程序。
FindAddIns(Type, String, String[])	从指定根目录中查找外接程序的指定宿主视图的所有外接程序。
Rebuild(PipelineStoreLocation)	重新生成管线段缓存并包括由 PipelineStoreLocation 值指定的位置上的新段。
Rebuild(String)	重新生成管线段缓存并包括指定根目录中的新段。
RebuildAddIns(String)	重新生成外接程序缓存并包括指定根目录中的新外接程序。
Update(PipelineStoreLocation)	用 PipelineStoreLocation 值指定的位置上的新段来更新管线段缓存。
Update(String)	用指定根目录中的新段更新管线段缓存。
UpdateAddIns(String)	更新外接程序缓存并包括指定位置处的新外接程序。

另请参阅

• 加载项和扩展性