Compartir a través de

Extensión (en tipo: CT_ApplicationExtensions)

  • Artículo

Declara un punto de extensibilidad para la aplicación.

Jerarquía de elemento

<Paquete>
<APLICACIONES>
<Application>
<Extensiones>
<Extensión>

Sintaxis

<Extension Category     = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
           Executable?  = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It 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 that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
           EntryPoint?  = A string between 1 and 256 characters in length, representing the task  handling the extension. This is 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 between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
           StartPage?   = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( FileTypeAssociation
  | Protocol
  | AutoPlayContent
  | AutoPlayDevice
  | ShareTarget
  | FileOpenPicker
  | FileSavePicker
  | BackgroundTasks
  )?

</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 de la aplicación.

Este atributo puede tener uno de los siguientes valores:

  • windows.fileTypeAssociation
  • windows.protocol
  • windows.autoPlayContent
  • windows.autoPlayDevice
  • windows.shareTarget
  • windows.search
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.cachedFileUpdater
  • windows.contactPicker
  • windows.backgroundTasks
  • windows.cameraSettings
  • windows.accountPictureProvider
  • windows.printTaskSettings
 Sí
EntryPoint

Identificador de clase activable.

 Cadena de entre 1 y 256 caracteres que representa la tarea que administra la extensión. Suele ser el nombre completo en el espacio de nombres de un tipo de Windows en tiempo de ejecución. Si no se especifica EntryPoint, se usa en su lugar el EntryPoint definido para la aplicación. No
Executable

Ejecutable de inicio predeterminado.

 Cadena de entre 1 y 256 caracteres que debe terminar con ".exe" y no puede contener estos caracteres: <, >, :, %, ", |, ?o *. Especifica el ejecutable predeterminado para la extensión. Si no se especifica, se usa el 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 el EntryPoint definido para la aplicación. No
RuntimeType

Proveedor en tiempo de ejecución. Este atributo se usa normalmente cuando hay marcos mixtos en una aplicación.

 Cadena de entre 1 y 255 caracteres que no puede iniciarse ni terminar con un punto o contener estos caracteres: <, , >:, %, ", /, \, |, ?o *. No
StartPage

La página web que administra el punto de extensibilidad.

 Cadena de entre 1 y 256 caracteres que no puede contener estos caracteres: <, >, :, %, ", |, ?o *. No

 

Elementos secundarios

Elemento secundario Descripción
AutoPlayContent

Declara un punto de extensibilidad de aplicación de tipo windows.autoPlayContent. La aplicación proporciona las acciones de contenido de Reproducción automática especificadas.
AutoPlayDevice

Declara un punto de extensibilidad de aplicación de tipo windows.autoPlayDevice. La aplicación proporciona las acciones de dispositivo de Reproducción automática especificadas.
BackgroundTasks

Define un punto de extensibilidad de aplicación de tipo windows.backgroundTasks. Las tareas en segundo plano se ejecutan en un host en segundo plano dedicado; es decir, sin una interfaz de usuario.
FileOpenPicker

Declara un punto de extensibilidad de aplicación de tipo windows.fileOpenPicker. La aplicación permite al usuario elegir y abrir los tipos de archivos especificados.
FileSavePicker

Declara un punto de extensibilidad de aplicación de tipo windows.fileSavePicker. La aplicación permite al usuario elegir el nombre de archivo, la extensión y la ubicación de almacenamiento para los tipos de archivos especificados.
FileTypeAssociation

Declara un punto de extensibilidad de aplicación de tipo windows.fileTypeAssociation. Una asociación de tipo de archivo indica que la aplicación está registrada para controlar los archivos de los tipos especificados.
Protocolo

Declara un punto de extensibilidad de 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.
ShareTarget

Declara un punto de extensión de aplicación de tipo windows.shareTarget. La aplicación puede compartir los tipos de archivos especificados.

 

Elementos primarios

Elemento primario Descripción
Extensiones (tipo: CT_ApplicationExtensions)

Define uno o varios puntos de extensibilidad para la aplicación.

 

Los elementos siguientes tienen el mismo nombre que este, pero contenido o atributos diferentes:

Comentarios

Estos puntos de extensibilidad solo se pueden declarar una vez por aplicación:

  • windows.accountPictureProvider
  • windows.cachedFileUpdater
  • windows.cameraSettings
  • windows.contactPicker
  • windows.fileOpenPicker
  • windows.fileSavePicker
  • windows.printTaskSettings
  • windows.search
  • windows.shareTarget

**Tenga en cuenta las reglas semánticas para extensiones: **Para cualquier elemento Extension, se aplican las siguientes reglas semánticas en la API de manifiesto:

Si se especifica /Application/@StartPage, es una aplicación Windows con JavaScript y la extensión de aplicación :

  • Puede estar vacío
  • Puede especificar solo startPage
  • Puede especificar Executable y EntryPoint (se permite RuntimeType opcional), a menos que sea una extensión BackgroundTask, en cuyo caso puede omitir el ejecutable y establecer el valor predeterminado en BackgroundTaskHost.exe ejecutable.

Si no se especifica /Application/@StartPage, es una aplicación para UWP que usa C# o VB y XAML y la extensión de aplicación :

  • Puede estar vacío
  • Puede especificar solo startPage
  • Debe especificar EntryPoint si se especifica Executable o RuntimeType.

Ejemplos

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

<Applications>
  <Application Id="App" StartPage="default.html">
    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>
    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>
      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Consulte también

ConceptosAprobaciones y contratos de aplicación

Requisitos

Value
Espacio de nombres http://schemas.microsoft.com/appx/2010/manifest