PackageDependency.Add メソッド

  • リファレンス

定義

名前空間:
Microsoft.Windows.ApplicationModel.DynamicDependency

オーバーロード

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

戻り値

PackageDependencyContext

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

属性
OverloadAttribute

注釈

このメソッドを呼び出すと、フレームワーク パッケージの依存関係がシステム上の特定のパッケージに解決されます。 また、フレームワーク パッケージがアクティブに使用されていること、およびバージョンの更新プログラムをサイド バイ サイドで処理することも 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

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

戻り値

PackageDependencyContext

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

属性
OverloadAttribute

注釈

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

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

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

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

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

こちらもご覧ください

適用対象