Launcher.LaunchUriAsync Methode

Referenz

Definition

Namespace:: Windows.System

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, wobei die angegebenen Optionen und Eingabedaten verwendet werden.
LaunchUriAsync(Uri, LauncherOptions)	Startet die Standard-App, die dem URI-Schemanamen oder dem ContentType für den angegebenen URI angegebenen Schemanamen zugeordnet ist, wobei die angegebenen Optionen verwendet werden.
LaunchUriAsync(Uri)	Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Bearbeiten

Startet die Standard-App, die dem URI-Schemanamen für den angegebenen URI zugeordnet ist, wobei die angegebenen Optionen und Eingabedaten verwendet werden.

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

uri: Uri Uri

Der URI.

options: LauncherOptions

Die Startoptionen für die App.

inputData: ValueSet

Die Eingabedaten für die App.

Wichtig

Die Menge der Daten, die übertragen werden können, darf nicht 100 KB überschreiten.

Gibt zurück

IAsyncOperation<Boolean> IAsyncOperation<bool>

Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; false andernfalls.

Attribute: OverloadAttribute

Hinweise

Sofern Sie diese API nicht aus einer Windows Desktopanwendung aufrufen, muss diese API innerhalb eines ASTA-Threads (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, ob es sich um eine Universelle Windows-Plattform (UWP)-App oder Windows Desktopanwendung handelt.

Siehe auch

Gilt für:

LaunchUriAsync(Uri, LauncherOptions)

Bearbeiten

Startet die Standard-App, die dem URI-Schemanamen oder dem ContentType für den angegebenen URI angegebenen Schemanamen zugeordnet ist, wobei die angegebenen Optionen verwendet werden.

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

uri: Uri Uri

Der URI.

options: LauncherOptions

Die Startoptionen für die App.

Gibt zurück

IAsyncOperation<Boolean> IAsyncOperation<bool>

Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; false andernfalls.

Attribute: OverloadAttribute

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 innerhalb eines ASTA-Threads aufgerufen werden (auch als UI-Thread bezeichnet).

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 Universelle Windows-Plattform-App (UWP)-App oder 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 innerhalb eines ASTA-Threads aufgerufen werden (auch als UI-Thread bezeichnet).

Sie müssen die privateNetworkClientServer-Funktion im Manifest angeben, um Intranet-URIs zu starten, z. B. einen file:/// URI, der auf einen Netzwerkspeicherort verweist.

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 auf Storage APIs Dateien zugreifen.

Der Inhaltstyp wird verwendet, um eine Dateierweiterung zu berechnen, aus der Erweiterung, die die Standard-App ausgewählt wird. Ein Inhaltstypwert von ""application/vnd.ms-word.document.12"" wird beispielsweise ".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 irgendeinem der obigen Gründe fehlschlägt, wird die API erfolgreich sein und false aus seinem asynchronen Vorgang zurückgeben.

Um dem Benutzer zu ermöglichen, eine App auszuwählen, 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.

Siehe auch

Gilt für:

LaunchUriAsync(Uri)

Bearbeiten

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

uri: Uri Uri

Der URI.

Gibt zurück

IAsyncOperation<Boolean> IAsyncOperation<bool>

Gibt true zurück, wenn die Standard-App für das URI-Schema gestartet wurde; false andernfalls.

Attribute: OverloadAttribute

Beispiele

In diesem Beispiel wird LaunchUriAsync(Uri) zum Starten eines URI verwendet.

// 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 innerhalb eines ASTA-Threads aufgerufen werden (auch als UI-Thread bezeichnet).

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 Universelle Windows-Plattform-App (UWP)-App oder 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 verweist.

Wenn der Start aus irgendeinem der obigen Gründe fehlschlägt, wird die API erfolgreich sein und false aus seinem asynchronen Vorgang zurückgeben.

Um dem Benutzer zu ermöglichen, eine App auszuwählen, 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.

Siehe auch

Gilt für:

Launcher.LaunchUriAsync Methode

Definition

Überlädt

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Parameter

Gibt zurück

Hinweise

Siehe auch

Gilt für:

LaunchUriAsync(Uri, LauncherOptions)

Parameter

Gibt zurück

Beispiele

Hinweise

Siehe auch

Gilt für:

LaunchUriAsync(Uri)

Parameter

Gibt zurück

Beispiele

Hinweise

Siehe auch

Gilt für:

Feedback