uap3:Extension (Windows 10)

Declara un punto de extensibilidad para la aplicación.

<Paquete>

      <APLICACIONES>

            <Application>

                 <\uap3:Extension>

Syntax

<uap3:Extension
    Category = 'A string that can be one of the following values: "windows.appointmentDataProvider", "windows.emailDataProvider", "windows.contactDataProvider", "windows.appUriHandler", "windows.appExtensionHost", "windows.appExtension", "windows.protocol", "windows.fileTypeAssociation".' |
    Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
    EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
    RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
    uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
    uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
    uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
    uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
    uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
    uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
    uap11:SupportsMultipleInstances = 'An optional boolean value.'
    uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
    uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
    uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
    desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

    <!-- Child elements -->
    uap3:appointmentDataProvider?
    uap3:emailDataProvider?
    uap3:contactDataProvider?
    uap3:appUriHandler?
    uap3:appService?
    uap3:appExecutionAlias?
    uap3:fileTypeAssociation?

</uap3:Extension>

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
Categoría	Tipo de punto de extensibilidad del paquete.	Cadena que puede tener uno de los siguientes valores: windows.appointmentDataProvider, windows.emailDataProvider, windows.contactDataProvider, windows.appUriHandler, windows.appExtensionHost, windows.appExtension, windows.protocol, windows.fileTypeAssociation.	Sí
EntryPoint	Identificador de clase activable.	Cadena con un valor entre 1 y 256 caracteres de longitud. Representa la tarea que controla la extensión (normalmente el nombre completo del espacio de nombres de un tipo de Windows Runtime). Si no se especifica EntryPoint, en su lugar se usa entryPoint definido para la aplicación.	No
Executable	Ejecutable de inicio predeterminado.	Cadena con un valor de entre 1 y 256 caracteres de longitud, que debe terminar con .exey no puede contener estos caracteres: <, >, :", |, , ?o *. Especifica el archivo ejecutable predeterminado para la extensión. Si no se especifica, se usa el archivo ejecutable definido para la aplicación. Si se especifica, también se usa la propiedad EntryPoint. Si no se especifica esa propiedad EntryPoint, se usa entryPoint definido para la aplicación.	No
RuntimeType	Proveedor en tiempo de ejecución. Normalmente se usa cuando hay marcos mezclados en una aplicación.	Cadena con un valor de entre 1 y 255 caracteres de longitud que no puede iniciar o terminar con un . o contener caracteres: <, >:|", ?o .*	No
StartPage	La página web que administra el punto de extensibilidad.	Cadena con un valor entre 1 y 256 caracteres de longitud que no puede contener estos caracteres: <, , >, ":|, ?, o .*	No
ResourceGroup	Etiqueta opcional que se usa para agrupar activaciones de extensión para fines de administración de recursos (por ejemplo, CPU y memoria). Consulte la sección Comentarios en Application@ResourceGroup.	Cadena alfanumérica entre 1 y 255 caracteres de longitud. Debe comenzar con una letra.	No
uap10:TrustLevel	Especifica el nivel de confianza de la extensión.	Valor de cadena opcional. Si se especifica, puede ser uno de los siguientes valores: appContainer o mediumIL.	No
uap10:RuntimeBehavior	Especifica el comportamiento en tiempo de ejecución de una extensión.	Valor de cadena opcional. Si se especifica, puede ser uno de los siguientes valores: windowsApp, packagedClassicApp o win32App.	No
uap10:HostId	Especifica el identificador del tiempo de ejecución del host para la extensión.	Cadena alfanumérica con un valor opcional entre 1 y 255 caracteres de longitud. Debe comenzar con una letra.	No
uap10:Parameters	Contiene parámetros de línea de comandos que se van a pasar a la extensión. Solo se admite para aplicaciones de escritorio.	Cadena con un valor de entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final.	No
uap11:Id	Identificador de la extensión. El identificador debe ser único para todas las extensiones de un paquete.	Cadena opcional con un valor entre 1 y 255 caracteres de longitud con un carácter de espacio no en blanco al principio y al final.	No
uap11:Subsystem	Este atributo se hereda de la sintaxis de extensión base y no es aplicable a la extensión com4. Aparte de la validación sintáctica, este valor se omite.	Cadena opcional que puede tener uno de los siguientes valores: consola o ventanas.	No
uap11:SupportsMultipleInstances	Especifica si las instancias deben ejecutarse en procesos diferentes. El valor predeterminado es false.	Valor booleano opcional.	No
uap11:ResourceGroup	Etiqueta que puede usar para agrupar activaciones de extensión con fines de administración de recursos (por ejemplo, CPU y memoria). El valor que puede establecer ResourceGroup es de forma libre y flexible. Consulte Application@ResourceGroup.	Cadena alfanumérica opcional con un valor entre 1 y 255 caracteres de longitud. Debe comenzar con una letra.	No
uap11:CurrentDirectoryPath	Especifica el directorio inicial cuando se inicia el proceso de aplicación.	Cadena opcional que no puede contener estos caracteres: <, >, |, ?o *. >	No
uap11:Parameters	Este atributo se hereda de la sintaxis de extensión base y no es aplicable a la extensión com4. Aparte de la validación sintáctica, se omite este valor.	Cadena opcional con un valor entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final.	No
desktop7:CompatMode	Especifica si la información de esta extensión se registra con Windows de maneras clásicas (por ejemplo, los tipos de registro de aplicaciones sin empaquetar con COM a través del Registro) o de nuevas formas más limitadas. El valor predeterminado es "modern". CompatMode="classic" requiere la funcionalidad Microsoft.classicAppCompat_8wekyb3d8bbwe .	Una cadena opcional puede tener uno de los siguientes valores: clásico o moderno.	No
desktop7:Scope	Especifica si los registros solo son visibles para otras aplicaciones que se ejecutan como un usuario que tiene este paquete registrado (usuario), o si son visibles para todos los usuarios y servicios del equipo (máquina). El valor predeterminado es "user". Scope="machine" requiere la funcionalidad Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Cadena opcional que puede tener uno de los siguientes valores: máquina o usuario.	No

Elementos secundarios

Elemento secundario	Descripción
uap3:AppointmentDataProvider	Declara un punto de extensibilidad de la aplicación de tipo windows.appointmentDataProvider.
uap3:EmailDataProvider	Declara un punto de extensibilidad de la aplicación de tipo windows.emailDataProvider.
uap3:ContactDataProvider	Declara un punto de extensibilidad de la aplicación de tipo windows.contactDataProvider.
uap3:AppUriHandler	Declara un punto de extensibilidad de la aplicación de tipo windows.appUriHandler.
uap3:AppExtensionHost	Declara un punto de extensibilidad de la aplicación de tipo windows.appExtensionHost.
uap3:AppExtension	Declara un punto de extensibilidad de la aplicación de tipo windows.appExtension.
uap3:AppService	Declara un punto de extensibilidad de la aplicación de tipo windows.appExtension.
uap3:AppExeuctionAlias	Declara un punto de extensibilidad de la aplicación de tipo windows.appExecutionAlias.
uap3:Protocol	Declara un punto de extensibilidad de la aplicación de tipo windows.protocol.
uap3:FileTypeAssociation	Declara un punto de extensibilidad de la aplicación de tipo windows.fileTypeAssociation.

Elementos primarios

Elemento primario	Descripción
Extensiones (tipo: CT_ApplicationExtensions)	Define uno o varios puntos de extensibilidad para la aplicación.

Ejemplos

<Package
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  
    IgnorableNamespaces="... uap3">
    <Applications>
        <Application>
            <Extensions>
                <uap3:Extension
                    Category="windows.appointmentDataProvider" 
                    EntryPoint="UserDataProvider.AppointmentDataProviderTask">  
                    <uap3:AppointmentDataProvider
                        ServerName="MyDataProvider.PPLE" />  
                </uap3:Extension>  
            </Extensions>
        </Application>
    </Applications>
</Package>

Requisitos

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