Dela via


Starta inställningssidan För standardappar

Lär dig hur du startar appen Windows-inställningar för att visa inställningssidan Standardappar från din app med hjälp av ms-settings-URI-schemat.

Windows definierar en uppsättning URI:er som gör att appar kan starta appen Windows-inställningar och visa en viss inställningssida. Den här artikeln beskriver hur du startar Appen Windows-inställningar direkt till sidan Standardinställningar för appar och om du vill kan du navigera direkt till inställningarna för ett angivet standardprogram. För mer information, se Starta appen Windows-inställningar.

Url:en för standardinställningar för appar

ms-settings:defaultapps startar appen Windows-inställningar och går till inställningssidan Standardappar. Från och med Windows 11 version 21H2 (med kumulativ uppdatering 2023-04), 22H2 (med kumulativ uppdatering 2023-04) och 23H2 eller senare kan du lägga till ytterligare en parameter för frågesträng i escaperat URI-format för att starta direkt till inställningssidan för ett specifikt program.

Det finns tre frågesträngsparametrar. Vilken frågesträngsparameter som ska användas beror på hur programmet installerades.

Frågesträngsparameter Värde som ska skickas
registreradAppAnvändare Namngivet värde från HKEY_CURRENT_USER\Software\RegisteredApplications

Använd när appen installerades för varje användare och när registreringen av appen skrevs till HKEY_CURRENT_USER\Software\RegisteredApplications.
registreradAppMaskin Namngivet värde från HKEY_LOCAL_MACHINE\Software\RegisteredApplications

Använd när appen installerades på varje dator och registreringen för appen skrevs till HKEY_LOCAL_MACHINE\Software\RegisteredApplications.
registeredAUMID Programanvändarmodell-ID

Använd när appen registrerades med Package Manager med hjälp av ett manifest som förklarar att appen hanterar filtyper (uap:FileTypeAssociation) eller URI-scheman (uap:Protocol).

Notera

För att frågesträngsparametern registeredAUMID ska fungera efter en os-uppgradering kan en app behöva öka sin TargetDeviceFamily... MaxVersionTested-värdet i manifestet. Detta säkerställer att appen indexeras om för användaren, vilket i sin tur uppdaterar lämpliga definitioner som används för att bearbeta djuplänken via protokollaktivering. MaxVersionTested bör uppdateras till 10.0.22000.1817 för Windows 11, version 21H2 eller 10.0.22621.1555 för Windows 11, version 22H2.

I följande exempel anropas LaunchUriAsync för att starta appen Windows-inställningar. Uri:n ms-settings:defaultapps anger att inställningssidan Standardappar ska visas. Därefter bestäms vilken app som ska startas. Till exempel registrerades "Microsoft Edge" av appen i HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Eftersom det är en installerad app per dator är registeredAppMachine frågesträngsparametern som ska användas. Den frivilliga frågesträngsparametern registeredAppMachine är inställd på det registrerade namnet genom ett anrop till Url.EscapeDataString, för att ange att sidan för Microsoft Edge- ska visas.

private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
    bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString("Microsoft Edge")));
}
bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));

Starta appen Windows-inställningar

Starta standardappen för en URI