AppListEntry.AppUserModelId Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the Application User Model ID (AUMID) for this AppListEntry
.
public:
property Platform::String ^ AppUserModelId { Platform::String ^ get(); };
winrt::hstring AppUserModelId();
public string AppUserModelId { get; }
var string = appListEntry.appUserModelId;
Public ReadOnly Property AppUserModelId As String
Property Value
A string representing the app's identity.
Windows requirements
Device family |
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduced in v5.0)
|
Examples
// Find and activate the desired application (if present on this machine)
using namespace Windows.Management.Deployment;
async Task<bool> RunApplicationAsync(string aumid)
{
var packageManager = new Windows.Management.Deployment.PackageManager();
IEnumerable<Package> packages = packageManager.FindPackagesForUserWithPackageTypes(
null, PackageTypes.Main | PackageTypes.Optional);
foreach (Package package in packages)
{
IReadOnlyList<AppListEntry> entries = await package.GetAppListEntriesAsync();
foreach (AppListEntry entry in entries)
{
if (String.Equals(entry.AppUserModelId, aumid, StringComparison.OrdinalIgnoreCase))
{
return await entry.LaunchAsync();
}
}
}
return false;
}
Remarks
An AUMID is a persistable value that you can use to identify an application. It's based on package family name + Package Relative Application ID (PRAID).
Identifier | Description |
---|---|
Package family name | Name + Publisher (the <Identity> element found in appxmanifest.xml). |
PRAID | The Id property of the Application found in appxmanifest.xml (e.g. <Application Id="Foo"...> ). |
The AUMID is independent of package version or architecture, so it can be used to identify an app across multiple versions or platforms.