Starta inställningssidan För standardappar

Lär dig hur du startar 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 Windows-inställningar och visa en viss inställningssida. Den här artikeln beskriver hur du startar Windows-inställningar direkt på sidan Standardinställningar för appar och om du vill kan du navigera direkt till inställningarna för ett angivet standardprogram. Mer information finns i Starta Windows-inställningar.

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

ms-settings:defaultapps startar Windows-inställningar och går till sidan Standardinställningar för appar. 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 LaunchUriAsync anropas för att starta 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")));

Relaterat innehåll

Starta Windows-inställningar

Starta standardappen för en URI