PackageDependency.Add 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Add() |
它會為你之前用 Create 方法建立的框架套件相依性新增執行時參考。 當此方法成功回傳後,你的應用程式可能會啟用類型並使用框架套件的內容。 |
| Add(AddPackageDependencyOptions) |
它會為你之前用 Create 方法建立的框架套件相依,並加上指定的選項,為你之前建立的執行時參考。 在此方法成功傳回之後,您的應用程式可以啟動類型,並使用架構套件的內容。 |
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
傳回
一個提供框架套件相依性上下文資訊的物件,並能讓你移除執行時的參考。
- 屬性
備註
呼叫此方法會將架構套件相依性解析為系統上的特定套件。 它也會通知作系統架構套件正在使用中,並排處理任何版本更新(有效地延遲卸載或維護舊版,直到您的應用程式完成使用為止)。 套件解析專屬於使用者,而且可以為系統上的不同用戶傳回不同的值。
每次成功 新增 呼叫都會將已解析的套件加入呼叫程序的套件圖中,即使該套件已經存在。 API 不會套用重複的偵測或篩選(也就是說,來自封裝的多個參考並不有害)。 解決完成後,該使用者的套件相依性會保持解決狀態,直到該使用者所有程序的最後一次引用透過 PackageDependencyContext.Remove 移除或程序終止。 成功呼叫此方法會改變 PackageDependency.GenerationId 的值。
當此方法成功回傳後,應用程式可以啟用型別並使用框架套件的內容,直到呼叫 PackageDependencyContext.Remove 為止。
若套件圖中存在多個與 Add 呼叫相同等級的套件,則解析後的套件會排在其他相同等級的套件之後加入。
如需詳細資訊,請參閱 使用動態相依性 API 在執行時間參考 MSIX 套件。
另請參閱
適用於
Add(AddPackageDependencyOptions)
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
定義了更多選項來指定框架套件參考。
傳回
一個提供框架套件相依性上下文資訊的物件,並能讓你移除執行時的參考。
- 屬性
備註
呼叫此方法會將架構套件相依性解析為系統上的特定套件。 它也會通知作系統架構套件正在使用中,並排處理任何版本更新(有效地延遲卸載或維護舊版,直到您的應用程式完成使用為止)。 套件解析專屬於使用者,而且可以為系統上的不同用戶傳回不同的值。
每次成功 新增 呼叫都會將已解析的套件加入呼叫程序的套件圖中,即使該套件已經存在。 API 不會套用重複的偵測或篩選(也就是說,來自封裝的多個參考並不有害)。 解決完成後,該使用者的套件相依性會保持解決狀態,直到該使用者所有程序的最後一次引用透過 PackageDependencyContext.Remove 移除或程序終止。 成功呼叫此方法會改變 PackageDependency.GenerationId 的值。
當此方法成功回傳後,應用程式可以啟用型別並使用框架套件的內容,直到呼叫 PackageDependencyContext.Remove 為止。
如果套件圖中存在多個與 Add 呼叫相同等級的套件,則該解析套件(預設情況下)會被加入其他相同等級的套件。 若要在同等級的其他套件之前加入套件,請在選項參數中指定 PrependIfRankCollision。
如需詳細資訊,請參閱 使用動態相依性 API 在執行時間參考 MSIX 套件。