PackageDependency.Add メソッド

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

返品

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

属性

OverloadAttribute

注釈

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

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

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

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

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

こちらもご覧ください

• 動的依存関係 API を使用して実行時に MSIX パッケージを参照

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

パラメーター

返品

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

属性

OverloadAttribute

注釈

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

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

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

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

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

こちらもご覧ください

• 動的依存関係 API を使用して実行時に MSIX パッケージを参照