uap：Rule (Windows 10)

指定 Web 上下文中的哪些页面有权访问系统的地理位置设备， (如果应用有权访问此功能) 并访问剪贴板。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <uap:ApplicationContentUriRules>

                   <uap:Rule>

语法

<uap:Rule
      Type = 'A string that can have one of the following values: "include" or "exclude".'
      Match = 'A string with a value between 1 and 2084 characters in length.'
      WindowsRuntimeAccess = 'An optional string that can have one of the following values: "allowForWebOnly", "all", or "none".' 
      uap5:ServiceWorker = 'An optional boolean value.' />

特性和元素

属性

属性	说明	数据类型	必须	默认值
类型	一个字符串，指定规则是包含规则还是排除规则。	可以具有以下值之一的字符串： include 或 exclude。	是
匹配	在规则中使用的 IRI。 有关详细信息，请参阅 RFC 3987： (I RI) 的国际化资源标识符。 它在包中对每个应用程序是唯一的，并且区分大小写。 例如， Match 的值可以是： https://www.microsoft.com/或 *.pdf。	一个字符串，其值长度介于 1 到 2084 个字符之间。	是
WindowsRuntimeAccess	声明 UWP (Windows 运行时) 从远程站点进行访问。 此属性为开发人员提供控制，以指定可从其网站访问 UWP API 的 URI 集。 如果 Type 设置为 exclude，则不允许此属性。	可具有以下值之一的可选字符串： allowForWebOnly (指示仅公开由开发人员创建并包含在应用包中的 UWP API。) ， 所有 (指示所有允许的 UWP API 都将可用。) ，或者 没有 (显式声明不会公开任何 UWP API。) 。	否	无
uap5：ServiceWorker	这表示从网页注册服务辅助角色 (渐进式 Web 应用) 作为 UWP 应用运行。 如果为 true，则确定应用导航到的 URL 是否具有将应用注册为服务辅助角色所需的权限。	可选的布尔值。	否

注意

要向 JavaScript 代码公开的 UWP Windows 运行时 类必须使用声明它的 AllowForWeb 属性进行修饰。

子元素

无。

父元素

父元素	描述
uap:ApplicationContentUriRules	指定 Web 上下文中的哪些页面有权访问系统的地理位置设备， (如果应用有权访问此功能) 并访问剪贴板。

注解

如果定义了多个规则，则规则的顺序很重要。

若要使用 Web 资源的 IRI 定义 Match 属性，可以仅指定安全 https: 站点 - 不允许不安全的“http：”站点。 如果指定站点http:，则会收到架构语义检查验证错误。

对于Windows 8.1 (版本 6.3.0) 中具有方案的任何值，清单仅允许安全https:方案。 清单无法通过任何其他方案。 为了向后兼容，此规则不适用于Windows 8应用。

要求

项	值
Namespace	http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version	Windows 10版本 1511 (内部版本 10586)