uap:Protocol (Windows 10)

声明 windows.protocol 类型的应用扩展点。 URI 关联指示已注册应用以使用指定方案处理 URI。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <扩展>

                   <uap:Extension>

                        <uap:Protocol>

语法

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

密钥

? 可选 (零个或一个) & 交错连接器 (可以按任意顺序出现)

特性和元素

属性

属性 说明 数据类型 必须 默认值
名称 URI 方案的名称 (如 mailto) 。 此名称对于包必须是唯一的。 值长度介于 2 到 39 个字符之间的字符串,包含数字、小写字母、句点 () . ,以及 (+) 或短划线 (-) 。 字符串不能以句点 (.) 开头。
DesiredView 启动约会时要使用的屏幕空间量。 可以具有以下值之一的字符串: defaultuseLessuseHalfuseMoreuseMinimum
ReturnResults 指定应用在通过 URI 激活调用时是否返回值。 可具有以下值之一的可选字符串:“none” (不返回值) ,“always” (URI 激活将始终返回结果) ,“可选” (URI 激活将返回结果(如果使用 LaunchUriForResultsAndContinueAsync) 激活结果)。

子元素

子元素 描述
uap:DisplayName 可向用户显示的友好名称。
uap:Logo 包含图像的文件的路径。
desktop7:ProgId 编程标识符 (可以与 CLSID 关联的 ProgID) 。

父元素

父元素 描述
uap:Extension 声明应用的扩展点。

示例

以下示例取自其中一个 SDK 示例的包清单。

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

另请参阅

任务如何处理 URI 激活

概念应用协定和扩展

要求

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