导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Launcher.LaunchUriAsync(Uri) | launchUriAsync(Uri) Method

启动与指定的 URI 方案名称相关联的默认应用程序。

语法


Windows.System.Launcher.launchUriAsync(uri).done( /* 你的成功和错误处理程序 */ );

参数

uri

类型: Windows.Foundation.Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

URI。

返回值

类型: IAsyncOperation<Boolean>

生成操作。

备注

当调用 API 时,调用应用程序必须对用户可见。

必须在清单中指定 privateNetworkClientServer 功能以生成 Intranet URI,如 file:/// URI 指向网络位置。

不能使用此方法在本地区域生成 URI。例如,应用程序不能使用 file:/// 协议访问本地计算机上的文件。代之以的是,您必须使用 Storage APIs 访问文件。

当对上述任何原因生成失败时,API 将成功并从其异步操作的 FALSE 返回。

若要使用户选择应用程序而不是生成默认应用程序,请设置 LauncherOptions.DisplayApplicationPicker | displayApplicationPicker 属性。

要显示表示 URI 可能不安全的警告,请设置 LauncherOptions.TreatAsUntrusted | treatAsUntrusted 属性。

URI 被传递给关联的应用程序。如果关联的应用程序为桌面应用程序,则使用外壳执行机制传递 URI。

示例

此示例使用 LaunchUriAsync(Uri) | launchUriAsync(Uri) 生成 URI。



// The URI to launch
var uriToLaunch = "http://www.bing.com";

// Create a Uri object from a URI string 
var uri = new Windows.Foundation.Uri(uriToLaunch);

// Launch the URI
Windows.System.Launcher.launchUriAsync(uri).then(   
   function (success) {
      if (success) {
        // URI launched
      } else {
        // URI launch failed
      }
   });

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8

命名空间

Windows.System
Windows::System [C++]

元数据

Windows.winmd

另请参见

示例
关联启动示例
准则
文件类型和 URI 的准则和检查表
任务
如何启动 URI 的默认应用程序 (JavaScript)
如何启动 URI 的默认应用程序 (C#/VB/C++)
引用
Launcher
LauncherOptions

 

 

显示:
© 2014 Microsoft