Launcher.LaunchUriAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| LaunchUriAsync(Uri, LauncherOptions, ValueSet) |
Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen und Eingabedaten. |
| LaunchUriAsync(Uri, LauncherOptions) |
Startet die Standard-App, die dem URI-Schemanamen oder dem durch den ContentType- für den angegebenen URI mit den angegebenen Optionen angegeben ist. |
| LaunchUriAsync(Uri) |
Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist. |
LaunchUriAsync(Uri, LauncherOptions, ValueSet)
Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, mithilfe der angegebenen Optionen und Eingabedaten.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options, ValueSet ^ inputData);/// [Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options, ValueSet const& inputData);[Windows.Foundation.Metadata.Overload("LaunchUriWithDataAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options, ValueSet inputData);function launchUriAsync(uri, options, inputData)Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions, inputData As ValueSet) As IAsyncOperation(Of Boolean)Parameter
- options
- LauncherOptions
Die Startoptionen für die App.
Wichtig
Die eigenschaft TargetApplicationPackageFamilyName der options parameter, während manchmal optional, ist für diese Überladung der LaunchUriAsync--Methode erforderlich.
- inputData
- ValueSet
Die Eingabedaten für die App.
Wichtig
Die Datenmenge, die übertragen werden kann, darf 100 KB nicht überschreiten.
Gibt zurück
Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; andernfalls "false".
- Attribute
Hinweise
Wenn Sie diese API nicht aus einer Windows-Desktopanwendung aufrufen, muss diese API in einem ASTA-Thread (auch als UI-Thread bezeichnet) aufgerufen werden.
Diese API kann auch von einer Windows-Desktopanwendung aufgerufen werden.
Diese API startet die Standard-App für das Schema, unabhängig davon, ob es sich um eine App für die universelle Windows-Plattform (UWP) oder eine Windows-Desktopanwendung handelt.
Weitere Informationen
Gilt für:
LaunchUriAsync(Uri, LauncherOptions)
Startet die Standard-App, die dem URI-Schemanamen oder dem durch den ContentType- für den angegebenen URI mit den angegebenen Optionen angegeben ist.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri, LauncherOptions ^ options);/// [Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri, LauncherOptions const& options);[Windows.Foundation.Metadata.Overload("LaunchUriWithOptionsAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri, LauncherOptions options);function launchUriAsync(uri, options)Public Shared Function LaunchUriAsync (uri As Uri, options As LauncherOptions) As IAsyncOperation(Of Boolean)Parameter
- options
- LauncherOptions
Die Startoptionen für die App.
Gibt zurück
Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; andernfalls "false".
- Attribute
Beispiele
In diesem Beispiel wird [LaunchUriAsync(Uri, LauncherOptions) verwendet, um einen URI mit einer Warnung zu starten. Die TreatAsUntrusted-Eigenschaft gibt an, dass das System eine Warnung anzeigen soll.
// The URI to launch
string uriToLaunch = @"http://www.bing.com";
var uri = new Uri(uriToLaunch);
async void DefaultLaunch()
{
// Set the option to show a warning
var options = new Windows.System.LauncherOptions();
options.TreatAsUntrusted = true;
// Launch the URI with a warning prompt
var success = await Windows.System.Launcher.LaunchUriAsync(uri, options);
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
}
// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
// Set the option to show a warning
Windows::System::LauncherOptions launcherOptions;
launcherOptions.TreatAsUntrusted(true);
// Launch the URI.
if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri, launcherOptions))
{
// URI launched.
}
else
{
// URI launch failed.
}
}
// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");
void MainPage::DefaultLaunch()
{
// Set the option to show a warning
auto launchOptions = ref new Windows::System::LauncherOptions();
launchOptions->TreatAsUntrusted = true;
// Launch the URI with a warning prompt
concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri, launchOptions));
launchUriOperation.then([](bool success)
{
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
});
}
' The URI to launch
Dim uri As New Uri("http://www.bing.com")
async Sub DefaultLaunch()
' Set the option to show a warning
Dim options = Windows.System.LauncherOptions()
options.TreatAsUntrusted = True
' Launch the URI with a warning prompt
Dim success = await Windows.System.Launcher.LaunchUriAsync(uri, options)
If success Then
' URI launched
Else
' URI launch failed
End If
End Sub
Hinweise
Wenn Sie diese API nicht aus einer Windows-Desktopanwendung aufrufen, muss diese API in einem ASTA-Thread (auch als UI-Thread bezeichnet) aufgerufen werden.
Diese API kann auch von einer Windows-Desktopanwendung aufgerufen werden.
Diese API startet die Standard-App für das Schema, unabhängig davon, ob es sich um eine App für die universelle Windows-Plattform (UWP) oder eine Windows-Desktopanwendung handelt.
Die aufrufende App muss für den Benutzer sichtbar sein, wenn diese API aufgerufen wird.
Wenn Sie diese API nicht aus einer Windows-Desktopanwendung aufrufen, muss diese API in einem ASTA-Thread (auch als UI-Thread bezeichnet) aufgerufen werden.
Sie müssen die privateNetworkClientServer--Funktion im Manifest angeben, um Intranet-URIs zu starten, z. B. einen file:///-URI, der auf einen Netzwerkspeicherort zeigt.
Sie können diese Methode nicht verwenden, um einen URI in der lokalen Zone zu starten. Beispielsweise können Apps das file:///-Protokoll nicht verwenden, um auf Dateien auf dem lokalen Computer zuzugreifen. Stattdessen müssen Sie die Speicher-APIs verwenden, um auf Dateien zuzugreifen.
Der Inhaltstyp wird verwendet, um eine Dateierweiterung zu berechnen, aus der Erweiterung, die die Standard-App ausgewählt wird. Beispielsweise wird ein Inhaltstypwert von ""application/vnd.ms-word.document.12"" ".docx" zugeordnet, und dann wird die Standardanwendung für ".docx" gestartet. Zum Beispiel:
// this specifies the file type, which is used to bind to Word.
launcherOptions.ContentType = "application/vnd.ms-word.document.12";
// and then this launches the file using the application
Launcher.LaunchUriAsync("http://www.cloud.com/file.docx", options);
Wenn der Start aus einem der oben genannten Gründe fehlschlägt, wird die API erfolgreich ausgeführt und gibt FALSE aus dem asynchronen Vorgang zurück.
Um dem Benutzer die Auswahl einer App zu ermöglichen, anstatt die Standard-App zu starten, legen Sie die LauncherOptions.DisplayApplicationPicker-Eigenschaft fest.
Um eine Warnung anzuzeigen, dass der URI potenziell unsicher ist, legen Sie die LauncherOptions.TreatAsUntrusted-Eigenschaft fest.
Der URI wird an die zugeordnete App übergeben. Wenn es sich bei der zugehörigen App um eine Desktop-App handelt, wird der URI mithilfe von Shellausführungsmechanismen übergeben.
Weitere Informationen
- LaunchUriAsync(Uri)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Zuordnungsstartbeispiel
- Richtlinien für Dateitypen und URIs
- Starten der Standard-App für einen URI-
Gilt für:
LaunchUriAsync(Uri)
Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist.
public:
static IAsyncOperation<bool> ^ LaunchUriAsync(Uri ^ uri);/// [Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
static IAsyncOperation<bool> LaunchUriAsync(Uri const& uri);[Windows.Foundation.Metadata.Overload("LaunchUriAsync")]
public static IAsyncOperation<bool> LaunchUriAsync(System.Uri uri);function launchUriAsync(uri)Public Shared Function LaunchUriAsync (uri As Uri) As IAsyncOperation(Of Boolean)Parameter
Gibt zurück
Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; andernfalls "false".
- Attribute
Beispiele
In diesem Beispiel wird LaunchUriAsync(Uri)- verwendet, um einen URI zu starten.
// The URI to launch
string uriToLaunch = @"http://www.bing.com";
// Create a Uri object from a URI string
var uri = new Uri(uriToLaunch);
// Launch the URI
async void DefaultLaunch()
{
// Launch the URI
var success = await Windows.System.Launcher.LaunchUriAsync(uri);
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
}
// The URI to launch.
Windows::Foundation::Uri m_uri{ L"http://www.bing.com" };
...
Windows::Foundation::IAsyncAction MainPage::DefaultLaunch()
{
// Launch the URI.
if (co_await Windows::System::Launcher::LaunchUriAsync(m_uri))
{
// URI launched.
}
else
{
// URI launch failed.
}
}
// The URI to launch
auto uri = ref new Windows::Foundation::Uri("http://www.bing.com");
void MainPage::DefaultLaunch()
{
// Launch the URI
concurrency::task<bool> launchUriOperation(Windows::System::Launcher::LaunchUriAsync(uri));
launchUriOperation.then([](bool success)
{
if (success)
{
// URI launched
}
else
{
// URI launch failed
}
});
}
' The URI to launch
Dim uri As New Uri("http://www.bing.com")
async Sub DefaultLaunch()
' Launch the URI
Dim success = await Windows.System.Launcher.LaunchUriAsync(uri)
If success Then
' URI launched
Else
' URI launch failed
End If
End Sub
Hinweise
Wenn Sie diese API nicht aus einer Windows-Desktopanwendung aufrufen, muss diese API in einem ASTA-Thread (auch als UI-Thread bezeichnet) aufgerufen werden.
Diese API kann auch von einer Windows-Desktopanwendung aufgerufen werden.
Diese API startet die Standard-App für das Schema, unabhängig davon, ob es sich um eine App für die universelle Windows-Plattform (UWP) oder eine Windows-Desktopanwendung handelt.
Die aufrufende App muss für den Benutzer sichtbar sein, wenn die API aufgerufen wird.
Sie müssen die privateNetworkClientServer--Funktion im Manifest angeben, um Intranet-URIs zu starten, z. B. einen file:///-URI, der auf einen Netzwerkspeicherort zeigt.
Sie können diese Methode nicht verwenden, um einen URI in der lokalen Zone zu starten. Beispielsweise können Apps das file:///-Protokoll nicht verwenden, um auf Dateien auf dem lokalen Computer zuzugreifen. Stattdessen müssen Sie die Speicher-APIs verwenden, um auf Dateien zuzugreifen.
Wenn der Start aus einem der oben genannten Gründe fehlschlägt, wird die API erfolgreich ausgeführt und gibt FALSE aus dem asynchronen Vorgang zurück.
Um dem Benutzer die Auswahl einer App zu ermöglichen, anstatt die Standard-App zu starten, legen Sie die LauncherOptions.DisplayApplicationPicker-Eigenschaft fest.
Um eine Warnung anzuzeigen, dass der URI potenziell unsicher ist, legen Sie die LauncherOptions.TreatAsUntrusted-Eigenschaft fest.
Der URI wird an die zugeordnete App übergeben. Wenn es sich bei der zugehörigen App um eine Desktop-App handelt, wird der URI mithilfe von Shellausführungsmechanismen übergeben.
Weitere Informationen
- LaunchUriAsync(Uri, LauncherOptions)
- LaunchUriAsync(Uri, LauncherOptions, ValueSet)
- Zuordnungsstartbeispiel
- Richtlinien für Dateitypen und URIs
- Starten der Standard-App für einen URI-
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für