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)

注釈

次の表で説明するように、このクラスを使用して2つのキャッシュファイルをビルド、再構築、および更新します。Use this class to build, rebuild, and update two cache files, as described in the following table.

キャッシュファイルCache file ファイルを作成するメソッドMethods that create the file
PipelineSegments.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.
AddIns.storeAddIns.store

このファイルは、1つまたは複数のアドインサブディレクトリが含まれるディレクトリにあります。This file is located in a directory that contains one or more add-in subdirectories. このディレクトリがパイプラインディレクトリ構造内にある場合は、AddIns という名前である必要があります。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.

重要

信頼されていないユーザーまたはエンティティが PipelineSegments にアクセスすることを許可していません。ストアおよびアドイン。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.

適用対象

こちらもご覧ください