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 包。

另请参阅

适用于