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 Требуемый объем экранного пространства, используемого при запуске встречи. Строка, которая может иметь одно из следующих значений: default, useLess, useHalf, useMore или useMinimum. Нет
ReturnResults Указывает, возвращает ли приложение значение при вызове с помощью активации URI. Необязательная строка, которая может иметь одно из следующих значений: "none" (не возвращает значение), "always" (активация URI всегда возвращает результат), "необязательная" (активация URI возвращает результат, если она активирована для результатов с помощью LaunchUriForResultsAndContinueAsync). Нет

Дочерние элементы

Дочерний элемент Описание
uap:DisplayName Понятное имя, которое может отображаться для пользователей.
uap:Logo Путь к файлу, который содержит изображение.
desktop7:ProgId Программный идентификатор (ProgID), который можно связать с CLSID.

Родительские элементы

Родительский элемент Описание
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

Основные понятияКонтракты и расширения приложений

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 версии 1511 (сборка 10586)