PackageDependency.Add メソッド

定義

オーバーロード

Add()

Create メソッドを使用して、前に作成したフレームワーク パッケージの依存関係のランタイム参照を 追加 します。 このメソッドが正常に戻った後、アプリは型をアクティブ化し、フレームワーク パッケージのコンテンツを使用する場合があります。

Add(AddPackageDependencyOptions)

Create メソッドを 使用して、指定したオプションを使用して、前に作成したフレームワーク パッケージ依存関係のランタイム参照を追加します。 このメソッドが正常に戻ったら、アプリで型をアクティブ化し、フレームワーク パッケージのコンテンツを使用できます。

Add()

Create メソッドを使用して、前に作成したフレームワーク パッケージの依存関係のランタイム参照を 追加 します。 このメソッドが正常に戻った後、アプリは型をアクティブ化し、フレームワーク パッケージのコンテンツを使用する場合があります。

public:
 virtual PackageDependencyContext ^ Add() = Add;
/// [Windows.Foundation.Metadata.Overload("Add")]
PackageDependencyContext Add();
[Windows.Foundation.Metadata.Overload("Add")]
public PackageDependencyContext Add();
function add()
Public Function Add () As PackageDependencyContext

戻り値

フレームワーク パッケージの依存関係に関するコンテキスト情報を提供し、実行時参照を削除できる オブジェクト。

属性

注釈

このメソッドを呼び出すと、フレームワーク パッケージの依存関係がシステム上の特定のパッケージに解決されます。 また、フレームワーク パッケージがアクティブに使用されていること、およびバージョンの更新プログラムをサイド バイ サイドで処理することも OS に通知します (アプリの使用が完了するまで、古いバージョンのアンインストールまたはその他のサービスを実質的に遅らせます)。 パッケージ解決はユーザーに固有であり、システム上のさまざまなユーザーに対して異なる値を返すことができます。

Add 呼び出しが成功するたびに、既に存在する場合でも、解決されたパッケージが呼び出し元プロセスのパッケージ グラフに追加されます。 API によって重複する検出やフィルター処理は適用されません (つまり、パッケージからの複数の参照は有害ではありません)。 解決が完了すると、そのユーザーのすべてのプロセスの最後の参照が PackageDependencyContext.Remove を介して削除されるか、プロセスが終了するまで、そのユーザーのパッケージ依存関係は解決された状態を維持します。 このメソッドの呼び出しが成功すると、 PackageDependency.GenerationId 値が 変更されます。

このメソッドが正常に戻った後、 PackageDependencyContext.Remove が呼び出されるまで、アプリは型をアクティブ化し、フレームワーク パッケージのコンテンツを使用できます。

Add の呼び出しと同じランクのパッケージ グラフに複数のパッケージが存在する場合、解決されたパッケージは同じランクの他のパッケージの後に追加されます。

詳細については、「 動的依存関係 API を使用して実行時に MSIX パッケージを参照する」を参照してください。

こちらもご覧ください

適用対象

Add(AddPackageDependencyOptions)

Create メソッドを 使用して、指定したオプションを使用して、前に作成したフレームワーク パッケージ依存関係のランタイム参照を追加します。 このメソッドが正常に戻ったら、アプリで型をアクティブ化し、フレームワーク パッケージのコンテンツを使用できます。

public:
 virtual PackageDependencyContext ^ Add(AddPackageDependencyOptions ^ options) = Add;
/// [Windows.Foundation.Metadata.Overload("Add2")]
PackageDependencyContext Add(AddPackageDependencyOptions const& options);
[Windows.Foundation.Metadata.Overload("Add2")]
public PackageDependencyContext Add(AddPackageDependencyOptions options);
function add(options)
Public Function Add (options As AddPackageDependencyOptions) As PackageDependencyContext

パラメーター

options
AddPackageDependencyOptions

フレームワーク パッケージ参照を指定するための追加オプションを定義します。

戻り値

フレームワーク パッケージの依存関係に関するコンテキスト情報を提供し、実行時参照を削除できる オブジェクト。

属性

注釈

このメソッドを呼び出すと、フレームワーク パッケージの依存関係がシステム上の特定のパッケージに解決されます。 また、フレームワーク パッケージがアクティブに使用されていること、およびバージョンの更新プログラムをサイド バイ サイドで処理することも OS に通知します (アプリの使用が完了するまで、古いバージョンのアンインストールまたはその他のサービスを実質的に遅らせます)。 パッケージ解決はユーザーに固有であり、システム上のさまざまなユーザーに対して異なる値を返すことができます。

Add 呼び出しが成功するたびに、既に存在する場合でも、解決されたパッケージが呼び出し元プロセスのパッケージ グラフに追加されます。 API によって重複する検出やフィルター処理は適用されません (つまり、パッケージからの複数の参照は有害ではありません)。 解決が完了すると、そのユーザーのすべてのプロセスの最後の参照が PackageDependencyContext.Remove を介して削除されるか、プロセスが終了するまで、そのユーザーのパッケージ依存関係は解決された状態を維持します。 このメソッドの呼び出しが成功すると、 PackageDependency.GenerationId 値が 変更されます。

このメソッドが正常に戻った後、 PackageDependencyContext.Remove が呼び出されるまで、アプリは型をアクティブ化し、フレームワーク パッケージのコンテンツを使用できます。

Add の呼び出しと同じランクのパッケージ グラフに複数のパッケージが存在する場合、解決されたパッケージは同じランクの他のパッケージの後に (既定で) 追加されます。 同じランクの他のユーザーの前にパッケージを追加するには、options パラメーターに PrependIfRankCollision を指定します。

詳細については、「 動的依存関係 API を使用して実行時に MSIX パッケージを参照する」を参照してください。

こちらもご覧ください

適用対象