Starten der Standard-App für einen URILaunch the default app for a URI

Wichtige APIsImportant APIs

Erfahren Sie, wie Sie die Standard-App für einen Uniform Resource Identifier (URI) starten.Learn how to launch the default app for a Uniform Resource Identifier (URI). URIs ermöglichen den Start einer anderen App zum Ausführen einer bestimmten Aufgabe.URIs allow you to launch another app to perform a specific task. Dieses Thema enthält auch eine Übersicht über die zahlreichen in Windows integrierten URI-Schemas.This topic also provides an overview of the many URI schemes built into Windows. Sie können außerdem benutzerdefinierte URIs starten.You can launch custom URIs too. Weitere Informationen zum Registrieren eines benutzerdefinierten URI-Schemas und Behandeln der URI-Aktivierung finden Sie unter Behandeln der URI-Aktivierung.For more info about registering a custom URI scheme and handling URI activation, see Handle URI activation.

Mit URI-Schemas können Sie Apps öffnen, indem Sie auf Hyperlinks klicken.URI schemes let you open apps by clicking hyperlinks. Genau wie Sie eine neue E-Mail mit mailto: öffnen, können Sie den Standardwebbrowser mit http: öffnen.Just as you can start a new email using mailto:, you can open the default web browser using http:

In diesem Thema werden einige der folgenden URI-Schemas beschrieben, die in Windows integriert sind:This topic describes the following URI schemes built into Windows:

URI-SchemaURI Scheme StartetLaunches
bingmaps:, MS-Drive-to: und MS-Walk-to:bingmaps:, ms-drive-to:, and ms-walk-to: Karten-AppMaps app
httphttp: StandardwebbrowserDefault web browser
mailtomailto: Standard-E-Mail-AppDefault email app
MS--Aufrufe:ms-call: Anruf-AppCall app
MS-Chat:ms-chat: Messaging-AppMessaging app
MS-People:ms-people: Kontakte-AppPeople app
MS-Fotos:ms-photos: Fotos-AppPhotos app
MS-Settings:ms-settings: Einstellungs-AppSettings app
MS-Store:ms-store: Store-AppStore app
MS-tonepicker:ms-tonepicker: TonauswahlTone picker
MS-yellowpage:ms-yellowpage: Nearby Numbers-AppNearby Numbers app
msnweather:msnweather: Wetter-AppWeather app

Der folgende URI öffnet beispielsweise den Standardbrowser und zeigt die Bing-Website an.For example, the following URI opens the default browser and displays the Bing web site.

https://bing.com

Sie können außerdem benutzerdefinierte URI-Schemas starten.You can also launch custom URI schemes too. Wenn zum Behandeln dieses URI keine App installiert ist, können Sie dem Benutzer die Installation einer App empfehlen.If there is no app installed to handle that URI, you can recommend an app for the user to install. Weitere Informationen erhalten Sie unter Empfehlen einer App, wenn keine App zur Behandlung des URI verfügbar ist.For more info, see Recommend an app if one is not available to handle the URI.

Im Allgemeinen kann die App nicht die App auswählen, die gestartet wird.In general, your app can't select the app that is launched. Der Benutzer entscheidet, welche App gestartet wird.The user determines which app is launched. Zum Behandeln desselben URI-Schemas kann mehr als eine App registriert werden.More than one app can register to handle the same URI scheme. Die einzige Ausnahme sind reservierte URI-Schemas.The exception to this is for reserved URI schemes. Registrierungen der reservierten URI-Schemas werden ignoriert.Registrations of reserved URI schemes are ignored. Die vollständige Liste der reservierten URI-Schemas finden Sie unter Behandeln der URI-Aktivierung.For the full list of reserved URI schemes, see Handle URI activation. In Fällen, in denen mehrere Apps das gleiche URI-Schema registriert haben, kann Ihre App das Starten einer bestimmten App empfehlen.In cases where more than one app may have registered the same URI scheme, your app can recommend a specific app to be launched. Weitere Informationen erhalten Sie unter Empfehlen einer App, wenn keine App zur Behandlung des URI verfügbar ist.For more info, see Recommend an app if one is not available to handle the URI.

Aufruf von „LaunchUriAsync“ zum Starten eines URICall LaunchUriAsync to launch a URI

Verwenden Sie die Methode LaunchUriAsync, um einen URI zu starten.Use the LaunchUriAsync method to launch a URI. Beim Aufrufen dieser Methode muss Ihre App im Vordergrund ausgeführt werden, d. h., sie muss für den Benutzer sichtbar sein.When you call this method, your app must be the foreground app, that is, it must be visible to the user. Durch diese Anforderung wird sichergestellt, dass der Benutzer zu jedem Zeitpunkt die Kontrolle behält.This requirement helps ensure that the user remains in control. Verknüpfen Sie alle URI-Startvorgänge direkt mit der Benutzeroberfläche Ihrer App, um sicherzustellen, dass diese Anforderung erfüllt wird.To meet this requirement, make sure that you tie all URI launches directly to the UI of your app. Der Benutzer muss immer eine Aktion ausführen, um einen URI zu starten.The user must always take some action to initiate a URI launch. Wenn Sie versuchen, einen URI zu starten, und Ihre App befindet sich nicht im Vordergrund, schlägt der Start fehl und Ihr Fehlerrückruf wird aufgerufen.If you attempt to launch a URI and your app isn't in the foreground, the launch will fail and your error callback will be invoked.

Erstellen Sie zunächst ein System.Uri-Objekt, das den URI darstellt, und übergeben Sie es anschließend an die Methode LaunchUriAsync.First create a System.Uri object to represent the URI, then pass that to the LaunchUriAsync method. Verwenden Sie das Ergebnis, um zu überprüfen, ob der Aufruf erfolgreich war, wie im folgenden Beispiel gezeigt.Use the return result to see if the call succeeded, as shown in the following example.

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // The URI to launch
   var uriBing = new Uri(@"http://www.bing.com");

   // Launch the URI
   var success = await Windows.System.Launcher.LaunchUriAsync(uriBing);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

In einigen Fällen fordert das Betriebssystem den Benutzer dazu auf, zu prüfen, ob er tatsächlich Apps wechseln möchte.In some cases, the operating system will prompt the user to see if they actually want to switch apps.

Überlagerndes Warndialogfeld in der App auf grauem Hintergrund.

Wenn diese Aufforderung stets erfolgen soll, verwenden Sie die Eigenschaft Windows.System.LauncherOptions.TreatAsUntrusted, um anzugeben, dass das Betriebssystem eine Warnung anzeigen soll.If you always want this prompt to occur, use the Windows.System.LauncherOptions.TreatAsUntrusted property to tell the operating system to display a warning.

// The URI to launch
var uriBing = new Uri(@"http://www.bing.com");

// Set the option to show a warning
var promptOptions = new Windows.System.LauncherOptions();
promptOptions.TreatAsUntrusted = true;

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriBing, promptOptions);

Empfehlen einer App, wenn keine App zur Behandlung des URI verfügbar istRecommend an app if one is not available to handle the URI

Es kann jedoch sein, dass der Benutzer nicht über die erforderliche App zum Bearbeiten des aufgerufenen URI verfügt.In some cases, the user might not have an app installed to handle the URI that you are launching. In diesen Fällen bietet das Betriebssystem standardmäßig einen Link an, über den Benutzer im Store nach einer geeigneten App suchen können.By default, the operating system handles these cases by providing the user with a link to search for an appropriate app on the store. Wenn Sie dem Benutzer eine bestimmte App für dieses spezifische Szenario empfehlen möchten, können Sie die Empfehlung zusammen mit dem gestarteten URI übergeben.If you want to give the user a specific recommendation for which app to acquire in this scenario, you can do so by passing that recommendation along with the URI that you are launching.

Empfehlungen sind auch nützlich, wenn mehr als eine App zum Behandeln eines URI-Schema registriert wurde.Recommendations are also useful when more than one app has registered to handle a URI scheme. Durch die Empfehlung einer bestimmten App öffnet Windows die App, wenn sie bereits installiert ist.By recommending a specific app, Windows will open that app if it is already installed.

Rufen Sie dazu die Methode Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) auf, wobei LauncherOptions.preferredApplicationPackageFamilyName auf den Paketfamiliennamen der empfohlenen App im Store festgelegt ist.To make a recommendation, call the Windows.System.Launcher.LaunchUriAsync(Uri, LauncherOptions) method with LauncherOptions.preferredApplicationPackageFamilyName set to the package family name of the app in the store that you want to recommend. Diese Info wird vom Betriebssystem verwendet, um die allgemeine Option zum Suchen einer App im Store durch eine spezifische Option zum Erwerben der empfohlenen App im Store zu ersetzen.The operating system uses this info to replace the general option to search for an app in the store with a specific option to acquire the recommended app from the store.

// Set the recommended app
var options = new Windows.System.LauncherOptions();
options.PreferredApplicationPackageFamilyName = "Contoso.URIApp_8wknc82po1e";
options.PreferredApplicationDisplayName = "Contoso URI Ap";

// Launch the URI and pass in the recommended app
// in case the user has no apps installed to handle the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

Festlegen der verbleibenden AnsichtseinstellungSet remaining view preference

Quell-Apps, die LaunchUriAsync aufrufen, können anfordern, nach dem Start eines URIs auf dem Bildschirm zu verbleiben.Source apps that call LaunchUriAsync can request that they remain on screen after a URI launch. Standardmäßig wird von Windows versucht, den gesamten verfügbaren Speicherplatz gleichmäßig zwischen der Quell- und der Ziel-App aufzuteilen, die den URI verarbeitet.By default, Windows attempts to share all available space equally between the source app and the target app that handles the URI. Quell-Apps können die Eigenschaft DesiredRemainingView verwenden. Hiermit geben sie dem Betriebssystem an, mehr oder weniger des verfügbaren Speicherplatzes für ihr App-Fenster zu verwenden.Source apps can use the DesiredRemainingView property to indicate to the operating system that they prefer their app window to take up more or less of the available space. DesiredRemainingView kann auch verwendet werden, um anzugeben, dass die Quell-App nach dem Start des URI nicht weiter auf dem Bildschirm angezeigt werden muss und vollständig durch die Ziel-App ersetzt werden kann.DesiredRemainingView can also be used to indicate that the source app doesn't need to remain on screen after the URI launch and can be completely replaced by the target app. Mit dieser Eigenschaft wird nur die bevorzugte Fenstergröße der aufrufenden App angegeben.This property only specifies the preferred window size of the calling app. Es wird nicht das Verhalten anderer Apps angegeben, die ggf. zur gleichen Zeit auf dem Bildschirm angezeigt werden.It doesn't specify the behavior of other apps that may happen to also be on screen at the same time.

Beachten Sie , dass  Windows mehrere verschiedene Faktoren berücksichtigt, wenn es die endgültige Fenstergröße der Quell-App bestimmt, z. b. die Einstellung der Quell-APP, die Anzahl der apps auf dem Bildschirm, die Bildschirm Ausrichtung usw.Note  Windows takes into account multiple different factors when it determines the source app's final window size, for example, the preference of the source app, the number of apps on screen, the screen orientation, and so on. Das Festlegen von DesiredRemainingView garantiert kein bestimmtes Fensterverhalten für die Quell-App.By setting DesiredRemainingView, you aren't guaranteed a specific windowing behavior for the source app.

// Set the desired remaining view.
var options = new Windows.System.LauncherOptions();
options.DesiredRemainingView = Windows.UI.ViewManagement.ViewSizePreference.UseLess;

// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uriContoso, options);

URI-SchemasURI Schemes

Die verschiedenen URI-Schemas werden im Folgenden beschrieben.The various URI schemes are described below.

URI-Schema für das Aufrufen einer AppCall app URI scheme

Sie können das URI-Schema ms-call: zum Starten der Anruf-App verwenden.Use the ms-call: URI scheme to launch the Call app.

URI-SchemaURI Scheme ErgebnisResult
ms-call:settingsms-call:settings Einstellungsseite der Anruf-App.Calls app settings page.

URI-Schema für E-MailEmail URI scheme

Sie können das URI-Schema mailto: verwenden, um die Standard-E-Mail-App zu starten.Use the mailto: URI scheme to launch the default mail app.

URI-SchemaURI Scheme ErgebnisseResults
mailto:mailto: Startet die Standard-E-Mail-App.Launches the default email app.
mailto:[e-Mail-Adresse]mailto:[email address] Startet die E-Mail-App und erstellt eine neue Nachricht mit der angegebenen E-Mail-Adresse in der Zeile „An“.Launches the email app and creates a new message with the specified email address on the To line. Beachten Sie, dass die E-Mail nicht gesendet wird, bis der Benutzer auf „Senden“ tippt.Note that the email is not sent until the user taps send.

HTTP-URI-SchemaHTTP URI scheme

Sie können das URI-Schema http: verwenden, um den Standard-Webbrowser zu starten.Use the http: URI scheme to launch the default web browser.

URI-SchemaURI Scheme ErgebnisseResults
http:http: Startet den Standardwebbrowser.Launches the default web browser.

URI-Schemas für die Karten-AppMaps app URI schemes

Sie können die URI-Schemas bingmaps: , ms-drive-to: und ms-walk-to: zum Starten der Windows-Karten-App für bestimmte Karten, Wegbeschreibungen und Suchergebnisse verwenden.Use the bingmaps:, ms-drive-to:, and ms-walk-to: URI schemes to launch the Windows Maps app to specific maps, directions, and search results. Der folgende URI startet beispielsweise die Windows-Karten-App und zeigt eine über New York City zentrierte Karte an.For example, the following URI opens the Windows Maps app and displays a map centered over New York City.

bingmaps:?cp=40.726966~-74.006076

Ein Beispiel der Windows-Karten-App.

Weitere Informationen finden Sie unter Starten der Windows-Karten-App.For more info, see Launch the Windows Maps app. Informationen zum Verwenden des Kartensteuerelements in Ihrer eigenen App finden Sie unter Anzeigen von Karten mit 2D-, 3D- und Streetside-Ansichten.To use the map control in your own app, see Display maps with 2D, 3D, and Streetside views.

URI-Schema für die Messaging-AppMessaging app URI scheme

Sie können das URI-Schema ms-chat: zum Starten der Windows Messaging-App verwenden.Use the ms-chat: URI scheme to launch the Windows Messaging app.

URI-SchemaURI scheme ErgebnisseResults
ms-chat:ms-chat: Startet die Messaging-App.Launches the Messaging app.
ms-chat:?ContactID={contacted}ms-chat:?ContactID={contacted} Damit kann die Messaging-Anwendung mit den Informationen eines bestimmten Kontakts gestartet werden.Allows the messaging application to be launched with a particular contact’s information.
ms-chat:?Body={body}ms-chat:?Body={body} Damit kann die Messaging-Anwendung mit einer Zeichenfolge gestartet werden, die als Inhalt der Nachricht verwendet wird.Allows the messaging application to be launched with a string to use as the content of the message.
ms-chat:?Addresses={address}&Body={body}ms-chat:?Addresses={address}&Body={body} Damit kann die Messaging-Anwendung mit bestimmten Adressinformationen und einer Zeichenfolge gestartet werden, die als Inhalt der Nachricht verwendet werden soll.Allows the messaging application to be launched with a particular addresses' information, and with a string to use as the content of the message. Hinweis: Die Adressen können verkettet werden.Note: Addresses can be concatenated.
ms-chat:?TransportId={transportId}ms-chat:?TransportId={transportId} Ermöglicht das Starten der Messaging-Anwendung mit einer bestimmten Transport-ID.Allows the messaging application to be launched with a particular transport ID.

URI-Schema für die TonauswahlTone picker URI scheme

Sie können das URI-Schema ms-tonepicker: verwenden, um Klingeltöne, Alarmtöne und Systemtöne zu wählen.Use the ms-tonepicker: URI scheme to choose ringtones, alarms, and system tones. Außerdem können Sie neue Klingeltöne speichern und den Anzeigenamen eines Tons abrufen.You can also save new ringtones and get the display name of a tone.

URI-SchemaURI Scheme ErgebnisseResults
ms-tonepicker:ms-tonepicker: Wählen Sie Klingeltöne, Alarmtöne und Systemtöne aus.Pick ringtones, alarms, and system tones.

Die Parameter werden über einen ValueSet an die LaunchURI-API übergeben.Parameters are passed via a ValueSet to the LaunchURI API. Weitere Informationen finden Sie unter Auswählen und Speichern von Tönen mit dem URI-Schema „ms-tonepicker“.See Choose and save tones using the ms-tonepicker URI scheme for details.

URI-Schema für die Nearby Numbers-AppNearby Numbers app URI scheme

Sie können das URI-Schema ms-yellowpage: zum Starten der Nearby Numbers-App verwenden.Use the ms-yellowpage: URI scheme to launch the Nearby Numbers app.

URI-SchemaURI Scheme ErgebnisseResults
MS-yellowpage:? Input =[-Schlüsselwort]&-Methode =[Zeichenfolge oder T9]ms-yellowpage:?input=[keyword]&method=[String or T9] Startet die Nearby Numbers-App.Launches the Nearby Numbers app.
input bezieht sich auf das Schlüsselwort, das Sie durchsuchen möchten.input refers to the keyword you want to search.
method bezieht sich auf den Suchtyp (String-oder T9-Suche).method refers to the type of search (string or T9 search).
Wenn method``T9 ist (eine Art der Tastatur), dann sollte keyword eine numerische Zeichenfolge sein, die der T9-Tastatur Buchstaben zuordnet, nach denen gesucht werden soll.If method is T9 (a type of keyboard) then keyword should be a numeric string that maps to the T9 keyboard letters to search for.
Wenn method``String ist, dann ist keyword das Schlüsselwort, nach dem gesucht werden soll.If method is String then keyword is the keyword to search for.

URI-Schema für die Kontakte-AppPeople app URI scheme

Sie können das URI-Schema ms-people: zum Starten der Kontakte-App verwenden.Use the ms-people: URI scheme to launch the People app. Weitere Informationen finden Sie unter Starten der Kontakte-App.For more info, see Launch the People app.

URI-Schema für die Fotos-AppPhotos app URI scheme

Sie können das URI-Schema ms-Fotos: zum Starten der Fotos-App verwenden, um ein Bild anzuzeigen oder ein Video zu bearbeiten.Use the ms-photos: URI scheme to launch the Photos app to view an image or edit a video. Zum Beispiel:For example:
So zeigen Sie ein Bild an: ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpgTo view an image: ms-photos:viewer?fileName=c:\users\userName\Pictures\image.jpg
Oder Bearbeiten eines Videos: ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03Or to edit a video: ms-photos:videoedit?InputToken=123abc&Action=Trim&StartTime=01:02:03

Hinweis

Die URIs zum Bearbeiten von Videos oder Anzeigen von Bildern sind nur auf dem Desktop verfügbar.The URIs to edit a video or display an image are only available on desktop.

URI-SchemaURI scheme ErgebnisseResults
ms-photos:viewer?fileName={filename}ms-photos:viewer?fileName={filename} Startet die Fotos-App, um das gewünschte Bild anzuzeigen. {filename} muss ein vollqualifizierter Pfadname sein.Launches the Photos app to view the specified image where {filename} is a fully-qualified path name. Beispiel: c:\users\userName\Pictures\ImageToView.jpgFor example: c:\users\userName\Pictures\ImageToView.jpg
ms-photos:videoedit?InputToken={input token}ms-photos:videoedit?InputToken={input token} Startet die Fotos-App im Videobearbeitungsmodus für die Datei, die durch das Dateitoken dargestellt wird.Launches the Photos app in video editing mode for the file represented by the file token. InputToken ist erforderlich.InputToken is required. Sie können den SharedStorageAccessManager verwenden, um ein Dateitoken zu erhalten.Use the SharedStorageAccessManager to get a token for a file.
ms-photos:videoedit?Action={action}ms-photos:videoedit?Action={action} Ein optionaler Parameter, der die Fotos-App im angegebenen Videobearbeitungsmodus öffnet. {Action} steht für eine der folgenden Optionen: SlowMotion, FrameExtraction, Kürzen, Ansicht, Freihand.An optional parameter that opens the Photos app in the specified video editing mode where {action} is one of: SlowMotion, FrameExtraction, Trim, View, Ink. Wenn keine Angabe erfolgt, wird standardmäßig Ansicht verwendetIf not specified, defaults to View
ms-photos:videoedit?StartTime={timespan}ms-photos:videoedit?StartTime={timespan} Ein optionaler Parameter, der angibt, wo die Wiedergabe des Videos beginnt.An optional parameter that specifies where to start playing the video. {timespan} muss im Format "hh:mm:ss.ffff"sein.{timespan} must be in the format "hh:mm:ss.ffff". Wenn nicht angegeben, wird standardmäßig 00:00:00.0000If not specified, defaults to 00:00:00.0000

URI-Schema für die Einstellungs-AppSettings app URI scheme

Sie können das URI-Schema ms-settings: zum Starten der Windows-Einstellungs-App verwenden.Use the ms-settings: URI scheme to launch the Windows Settings app. Das Starten der Einstellungs-App ist ein wichtiger Bestandteil beim Schreiben einer datenschutzbewussten App.Launching to the Settings app is an important part of writing a privacy-aware app. Wenn Ihre App nicht auf eine sensible Ressource zugreifen kann, wird empfohlen, dem Benutzer einen praktischen Link zu den Datenschutzeinstellungen für diese Ressource bereitzustellen.If your app can't access a sensitive resource, we recommend providing the user a convenient link to the privacy settings for that resource. Folgender URI öffnet beispielsweise die Einstellungs-App und zeigt die Datenschutzeinstellungen für die Kamera an.For example, the following URI opens the Settings app and displays the camera privacy settings.

ms-settings:privacy-webcam

Datenschutzeinstellungen für die Kamera.

Weitere Informationen finden Sie unter Starten der Einstellungs-App von Windows und Richtlinien für Apps mit Berücksichtigung von Datenschutz.For more info, see Launch the Windows Settings app and Guidelines for privacy-aware apps.

URI-Schema für die Store-AppStore app URI scheme

Sie können das URI-Schema ms-windows-store: zum Starten der UWP-App verwenden.Use the ms-windows-store: URI scheme to Launch the UWP app. Öffnen Sie Seiten mit Produktdetails, Produktbewertungen sowie Suchseiten. Der folgende URI öffnet z. B. die UWP-App und startet die Store-Startseite.Open product detail pages, product review pages, and search pages, etc. For example, the following URI opens the UWP app and launches the home page of the Store.

ms-windows-store://home/

Weitere Informationen finden Sie unter Starten der UWP-App.For more info, see Launch the UWP app.

URI-Schema für Wetter-AppWeather app URI scheme

Verwenden Sie das Schema msnweather: URI, um die Wetter-App zu starten.Use the msnweather: URI scheme to launch the Weather app.

URI-SchemaURI Scheme ErgebnisseResults
msnweather://Forecast? La =[breiten]& Lo =[Längengrad]msnweather://forecast?la=[latitude]&lo=[longitude] Hiermit wird die Wetter-App auf der Seite "Vorhersage" basierend auf geografischen Koordinaten des Standorts gestartet.Launches the Weather app in the Forecast page based on a location geographic coordinates.
latitude bezieht sich auf den Breitengrad des Standorts.latitude refers to the latitude of the location.
longitude bezieht sich auf den Längengrad der Position.longitude refers to the longitude of the location.