Launcher.LaunchUriAsync 方法

參考

定義

命名空間:: Windows.System

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

LaunchUriAsync(Uri, LauncherOptions, ValueSet)	使用指定的選項和輸入數據，啟動與指定 URI 之 URI 配置名稱相關聯的預設應用程式。
LaunchUriAsync(Uri, LauncherOptions)	使用指定的選項，啟動與 URI 配置名稱相關聯的預設應用程式，或由 ContentType 所指定的應用程式，指定的 URI。
LaunchUriAsync(Uri)	啟動與指定 URI 之 URI 配置名稱相關聯的預設應用程式。

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

編輯

使用指定的選項和輸入數據，啟動與指定 URI 之 URI 配置名稱相關聯的預設應用程式。

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)

參數

uri: Uri Uri

URI。

options: LauncherOptions

應用程式的啟動選項。

重要

選項參數的 TargetApplicationPackageFamilyName 屬性，有時為 LaunchUriAsync 方法的這個多載所需。

inputData: ValueSet

應用程式的輸入數據。

重要

可以傳輸的數據量不得超過 100 KB。

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

如果啟動 URI 配置的預設應用程式，則傳回 true true;否則 false。

屬性: OverloadAttribute

備註

除非您從 Windows 傳統型應用程式呼叫此 API，否則必須在 ASTA 線程內呼叫此 API（也稱為 UI 線程）。

您也可以從 Windows 傳統型應用程式呼叫此 API。

此 API 會啟動配置的預設應用程式，無論是通用 Windows 平臺（UWP）應用程式還是 Windows 傳統型應用程式。

另請參閱

適用於

LaunchUriAsync(Uri, LauncherOptions)

編輯

使用指定的選項，啟動與 URI 配置名稱相關聯的預設應用程式，或由 ContentType 所指定的應用程式，指定的 URI。

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)

參數

uri: Uri Uri

URI。

options: LauncherOptions

應用程式的啟動選項。

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

如果啟動 URI 配置的預設應用程式，則傳回 true true;否則 false。

屬性: OverloadAttribute

範例

此範例會使用 [LaunchUriAsync（Uri， LauncherOptions）來啟動具有警告的 URI。 TreatAsUntrusted 屬性表示系統應該顯示警告。

// 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

備註

除非您從 Windows 傳統型應用程式呼叫此 API，否則必須在 ASTA 線程內呼叫此 API（也稱為 UI 線程）。

您也可以從 Windows 傳統型應用程式呼叫此 API。

此 API 會啟動配置的預設應用程式，無論是通用 Windows 平臺（UWP）應用程式還是 Windows 傳統型應用程式。

叫用此 API 時，用戶必須可以看到呼叫的應用程式。

除非您從 Windows 傳統型應用程式呼叫此 API，否則必須在 ASTA 線程內呼叫此 API（也稱為 UI 線程）。

您必須在指令清單中指定 privateNetworkClientServer 功能，才能啟動內部網路 URI，例如指向網路位置的 file:/// URI。

您無法使用此方法在本機區域中啟動 URI。例如，應用程式無法使用 file:/// 通訊協定來存取本機電腦上的檔案。相反地，您必須使用記憶體 API 來存取檔案。

內容類型是用來從預設應用程式選擇的擴展名計算擴展名。例如，“”application/vnd.ms-word.document.12“ 的內容類型值會對應至 ”.docx“，然後啟動 ”.docx“ 的默認應用程式。例如：

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

因為上述任何原因而啟動失敗時，API 將會成功，並從其異步操作傳回 FALSE。

若要讓使用者選擇應用程式，而不是啟動默認應用程式，請設定 LauncherOptions.DisplayApplicationPicker 屬性。

若要顯示 URI 可能不安全的警告，請設定 LauncherOptions.TreatAsUntrusted 屬性。

URI 會傳遞至相關聯的應用程式。如果相關聯的應用程式是傳統型應用程式，則會使用殼層執行機制傳遞URI。

另請參閱

適用於

LaunchUriAsync(Uri)

編輯

啟動與指定 URI 之 URI 配置名稱相關聯的預設應用程式。

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)

參數

uri: Uri Uri

URI。

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

如果啟動 URI 配置的預設應用程式，則傳回 true true;否則 false。

屬性: OverloadAttribute

範例

此範例會使用 LaunchUriAsync（Uri） 來啟動 URI。

// 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

備註

除非您從 Windows 傳統型應用程式呼叫此 API，否則必須在 ASTA 線程內呼叫此 API（也稱為 UI 線程）。

您也可以從 Windows 傳統型應用程式呼叫此 API。

此 API 會啟動配置的預設應用程式，無論是通用 Windows 平臺（UWP）應用程式還是 Windows 傳統型應用程式。

叫用 API 時，用戶必須可以看到呼叫的應用程式。

您必須在指令清單中指定 privateNetworkClientServer 功能，才能啟動內部網路 URI，例如指向網路位置的 file:/// URI。

因為上述任何原因而啟動失敗時，API 將會成功，並從其異步操作傳回 FALSE。

若要讓使用者選擇應用程式，而不是啟動默認應用程式，請設定 LauncherOptions.DisplayApplicationPicker 屬性。

若要顯示 URI 可能不安全的警告，請設定 LauncherOptions.TreatAsUntrusted 屬性。

URI 會傳遞至相關聯的應用程式。如果相關聯的應用程式是傳統型應用程式，則會使用殼層執行機制傳遞URI。

另請參閱

適用於

共用方式為

Launcher.LaunchUriAsync 方法

定義

多載

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

參數

傳回

備註

另請參閱

適用於

LaunchUriAsync(Uri, LauncherOptions)

參數

傳回

範例

備註

另請參閱

適用於

LaunchUriAsync(Uri)

參數

傳回

範例

備註

另請參閱

適用於

意見反應

其他資源