PackageCatalog.OpenForPackage(Package) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
允許接聽任何 Package 及其相依 (選擇性、資源和 hostRuntime) 。
public:
static PackageCatalog ^ OpenForPackage(Package ^ package);
static PackageCatalog OpenForPackage(Package const& package);
public static PackageCatalog OpenForPackage(Package package);
function openForPackage(package)
Public Shared Function OpenForPackage (package As Package) As PackageCatalog
參數
- package
- Package
將監視通知的 套件 。
傳回
用來接聽部署通知的 PackageCatalog 。
Windows 需求
裝置系列 |
Windows 11 Insider Preview (已於 10.0.23504.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v15.0 引進)
|
範例
此範例會使用 OpenForPackage 方法來接聽目前套件 (Package.Current) 的通知。 事件處理常式會針對任何已完成更新的選擇性套件採取動作。
void RegisterForDeploymentNotifications()
{
if (catalog == null)
{
catalog = PackageCatalog.OpenForPackage(Package.Current);
catalog.PackageUpdating += OptionalPackageUpdatingCallback;
}
}
void OptionalPackageUpdatingCallback(object sender, PackageUpdatingEventArgs args)
{
if (args.IsComplete && args.TargetPackage.IsOptional)
{
// Let the user know the Optional package has updated, and can be used now
var messageDialog = new MessageDialog(args.TargetPackage.DisplayName +
" has been updated. Please restart the app to enjoy our latest features.");
}
}
備註
除非呼叫目前封裝) ,否則此 API 需要 packageQuery 功能 (。
此 API 可讓套件接聽另一個套件及其相依 (的部署通知,例如 PWA) 。