Compartir a través de

uap:Protocol (Windows 10)

  • Artículo

Declara un punto de extensibilidad de la aplicación de tipo windows.protocol. Una asociación de URI indica que la aplicación está registrada para controlar los URI con el esquema especificado.

Jerarquía de elemento

<Paquete>

    <APLICACIONES>

         <Application>

              <Extensiones>

                   <uap:Extension>

                        <uap:Protocol>

Syntax

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

Clave

? conector opcional (cero o uno) & intercalado (puede producirse en cualquier orden)

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
Nombre Nombre del esquema de URI (por mailtoejemplo, ). Este nombre debe ser único para el paquete. Cadena con un valor entre 2 y 39 caracteres de longitud que contiene números, letras minúsculas, puntos (.), signos más (+) o guiones (-). La cadena no puede comenzar con un punto (.). Sí
DesiredView Cantidad deseada de espacio en pantalla que se va a usar cuando se inicia la cita. Cadena que puede tener uno de los siguientes valores: default, useLess, useHalf, useMore o useMinimum. No
ReturnResults Especifica si la aplicación devuelve un valor cuando se invoca a través de una activación de URI. Cadena opcional que puede tener uno de los siguientes valores: "none" (no devuelve un valor), "always" (la activación de URI siempre devolverá un resultado), "opcional" (la activación de URI devolverá un resultado si se activa para los resultados mediante LaunchUriForResultsAndContinueAsync). No

Elementos secundarios

Elemento secundario Descripción
uap:DisplayName Nombre descriptivo que se puede mostrar a los usuarios.
uap:Logo Ruta de acceso a un archivo que contiene una imagen.
desktop7:ProgId Identificador de programación (ProgID) que se puede asociar a un CLSID.

Elementos primarios

Elemento primario Descripción
uap:Extension Declara un punto de extensibilidad para la aplicación.

Ejemplos

El ejemplo siguiente se toma del manifiesto del paquete de uno de los ejemplos del SDK.

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

Consulte también

TareasCómo controlar la activación de URI

Conceptos Contratosy extensiones de aplicaciones

Requisitos

Elemento Value
Espacio de nombres http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 versión 1511 (compilación 10586)