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

備註

呼叫這個方法會將架構套件相依性解析為系統上的特定套件。 它也會通知作業系統架構套件正在使用中，並排處理任何版本更新， (有效地延遲卸載或維護較舊版本，直到您的應用程式使用完成) 為止。 套件解析是使用者特有的，而且可以針對系統上的不同使用者傳回不同的值。

每個成功的 Add 呼叫都會將解析的封裝新增至呼叫程式的封裝圖形，即使已經存在也一樣。 API (不會套用重複的偵測或篩選，也就是說，來自套件的多個參考不會有害) 。 解決完成之後，套件相依性會維持為該使用者解析，直到透過 PackageDependencyCoNtext.Remove 移除該使用者之所有進程的最後一個參考為止，或進程終止為止。 成功呼叫此方法會變更 PackageDependency.GenerationId 值。

在此方法成功傳回之後，您的應用程式可以啟動類型並使用架構套件的內容，直到呼叫 PackageDependencyCoNtext.Remove 為止。

如果套件圖形中有多個套件，且排名與呼叫 Add相同，則解析的套件會在相同排名的其他套件之後新增。

如需詳細資訊，請參閱 使用動態相依性 API 在執行時間參考 MSIX 套件。

另請參閱

• 使用動態相依性 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

備註

呼叫這個方法會將架構套件相依性解析為系統上的特定套件。 它也會通知作業系統架構套件正在使用中，並排處理任何版本更新， (有效地延遲卸載或維護較舊版本，直到您的應用程式使用完成) 為止。 套件解析是使用者特有的，而且可以針對系統上的不同使用者傳回不同的值。

每個成功的 Add 呼叫都會將解析的封裝新增至呼叫程式的封裝圖形，即使已經存在也一樣。 API (不會套用重複的偵測或篩選，也就是說，來自套件的多個參考不會有害) 。 解決完成之後，套件相依性會維持為該使用者解析，直到透過 PackageDependencyCoNtext.Remove 移除該使用者之所有進程的最後一個參考為止，或進程終止為止。 成功呼叫此方法會變更 PackageDependency.GenerationId 值。

在此方法成功傳回之後，您的應用程式可以啟動類型並使用架構套件的內容，直到呼叫 PackageDependencyCoNtext.Remove 為止。

如果套件圖形中有多個套件與呼叫 Add相同的排名，則預設會將解析的套件 (，) 相同排名的其他套件之後新增。 若要在相同排名的其他套件之前新增套件，請為options參數指定PrependIfRankCollision。

如需詳細資訊，請參閱 使用動態相依性 API 在執行時間參考 MSIX 套件。

另請參閱

• 使用動態相依性 API 在執行時間參考 MSIX 套件