Udostępnij przez


Uruchamianie strony Ustawień aplikacji domyślnych

Dowiedz się, jak uruchomić Ustawienia systemu Windows, aby wyświetlić stronę ustawień Domyślnych aplikacji z poziomu aplikacji, korzystając z schematu identyfikatora URI ms-settings.

System Windows definiuje zestaw identyfikatorów URI, które umożliwiają aplikacjom uruchamianie ustawień systemu Windows i wyświetlanie określonej strony ustawień. W tym artykule wyjaśniono, jak uruchomić ustawienia systemu Windows bezpośrednio na stronie Ustawienia domyślne, a opcjonalnie przejdź bezpośrednio do ustawień określonej aplikacji domyślnej. Aby uzyskać więcej informacji, zobacz Uruchamianie ustawień systemu Windows.

Adres URL ustawień domyślnych aplikacji

ms-settings:defaultapps uruchamia ustawienia systemu Windows i przechodzi do strony Ustawienia domyślne aplikacji. Począwszy od systemu Windows 11 w wersji 21H2 (z aktualizacją zbiorczą z kwietnia 2023), 22H2 (z aktualizacją zbiorczą z kwietnia 2023) i 23H2 lub nowszych, można dodać dodatkowy parametr ciągu zapytania w formacie zakodowanego identyfikatora URI, aby przejść bezpośrednio do strony ustawień określonej aplikacji.

Istnieją trzy parametry ciągu zapytania. Parametr ciągu zapytania do użycia zależy od sposobu instalowania aplikacji.

Parametr ciągu zapytania Wartość do przekazania
zarejestrowanyUżytkownikAplikacji Nazwana wartość z HKEY_CURRENT_USER\Software\RegisteredApplications

Użyj tego polecenia, gdy aplikacja została zainstalowana dla konkretnego użytkownika, a jej rejestracja została zapisana w HKEY_CURRENT_USER\Software\RegisteredApplications.
registeredAppMachine Nazwa wartości z HKEY_LOCAL_MACHINE\Software\RegisteredApplications

Użyj, kiedy aplikacja została zainstalowana na komputerze, a jej rejestracja została zapisana w HKEY_LOCAL_MACHINE\Software\RegisteredApplications.
registeredAUMID Identyfikator modelu użytkownika aplikacji

Użyj polecenia, gdy aplikacja została zarejestrowana w Menedżerze pakietów za pomocą manifestu deklarującego, że aplikacja obsługuje typy plików (uap:FileTypeAssociation) lub schematy URI (uap:Protocol).

Notatka

Aby parametr ciągu zapytania registeredAUMID działał po uaktualnieniu systemu operacyjnego, może być konieczne zwiększenie wartości jego elementu TargetDeviceFamily...MaxVersionTested w manifeście. Dzięki temu aplikacja zostanie ponownie zindeksowana dla użytkownika, co z kolei zaktualizuje odpowiednie definicje używane do przetwarzania linku głębokiego za pośrednictwem aktywacji protokołu. Wartość MaxVersionTest powinna zostać zaktualizowana do 10.0.22000.1817 dla systemu Windows 11 w wersji 21H2 lub 10.0.22621.1555 dla systemu Windows 11 w wersji 22H2.

W poniższym przykładzie wywoływana jest funkcja LaunchUriAsync w celu uruchomienia ustawień systemu Windows. Identyfikator URI ms-settings:defaultapps określa, że powinna być wyświetlana strona Ustawień domyślnych aplikacji. Następnie określana jest aplikacja, która ma zostać uruchomiona. Na przykład "Microsoft Edge" został zarejestrowany w aplikacji HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Ponieważ jest to aplikacja zainstalowana na maszynie, registeredAppMachine jest parametrem ciągu zapytania, który powinien być używany. Opcjonalny parametr ciągu zapytania registeredAppMachine jest ustawiony na zarejestrowaną nazwę, przeformatowaną poprzez wywołanie funkcji Url.EscapeDataString, aby wskazać, że strona dotycząca Microsoft Edge powinna być wyświetlana.

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")));

Uruchamianie ustawień systemu Windows

Uruchamianie domyślnej aplikacji dla identyfikatora URI