Elemento <file> (aplicación ClickOnce)

  • Artículo

Identifica todos los archivos nonassembly descargados y usados por la aplicación.

Syntax

<file
    name
    size
    group
    optional
    writeableType
>
    <typelib
        tlbid
        version
        helpdir
        resourceid
        flags
    />
    <comClass
        clsid
        description
        threadingModel
        tlbid
        progid
        miscStatus
        miscStatusIcon
        miscStatusContent
        miscStatusDocPrint
        miscStatusThumbnail
    />
    <comInterfaceExternalProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <comInterfaceProxyStub
        iid
        baseInterface
        numMethods
        name
        tlbid
        proxyStubClass32
    />
    <windowClass
        versioned
    />
</file>

Elementos y atributos

El elemento file es opcional. El elemento tiene los atributos siguientes.

Atributo Descripción
name Necesario. Identifica el nombre del archivo.
size Necesario. Especifica el tamaño, en bytes, del archivo.
group Opcional, si el atributo optional no se especifica o se establece en false; obligatorio si optional es true. Nombre del grupo al que pertenece este archivo. El nombre puede ser cualquier valor de cadena Unicode elegido por el desarrollador y se usa para descargar archivos a petición con la clase ApplicationDeployment.
optional Opcional. Especifica si este archivo debe descargarse cuando se ejecuta por primera vez la aplicación o si el archivo debe residir solo en el servidor hasta que la aplicación lo solicite a petición. Si false o indefinido, el archivo se descarga cuando la aplicación se ejecuta o instala por primera vez. Si true, debe especificarse un group para que el manifiesto de aplicación sea válido. optional no puede ser true si writeableType se especifica con el valor applicationData.
writeableType Opcional. Especifica que este archivo es un archivo de datos. Actualmente, el único valor válido es: applicationData.

typelib

El elemento typelib es un elemento secundario opcional del elemento file. El elemento describe la biblioteca de tipos que pertenece al componente COM. El elemento tiene los atributos siguientes.

Atributo Descripción
tlbid Necesario. GUID asignado a la biblioteca de tipos.
version Necesario. Número de versión de la biblioteca de tipos.
helpdir Necesario. Directorio que contiene los archivos de Ayuda del componente. Puede ser de longitud cero.
resourceid Opcional. La representación hexadecimal en cadena del identificador de configuración regional (LCID). Es de uno a cuatro dígitos hexadecimales sin un prefijo 0x y sin ceros iniciales. El LCID puede tener un identificador de sublanguaje neutro.
flags Opcional. La representación en cadena de las banderas de la biblioteca de tipos para esta biblioteca de tipos. En concreto, debe ser "RESTRICTED", "CONTROL", "HIDDEN" y "HASDISKIMAGE".

comClass

El elemento comClass es un elemento secundario opcional del elemento file, pero es necesario si la aplicación ClickOnce contiene un componente COM que pretende implementar utilizando COM sin registro. El elemento tiene los atributos siguientes.

Atributo Descripción
clsid Necesario. Identificador de clase del componente COM expresado como GUID.
description Opcional. El nombre de la clase.
threadingModel Opcional. El modelo de subprocesos utilizado por las clases COM en proceso. Si esta propiedad es null, no se usa ningún modelo de subprocesos. El componente se crea en el subproceso principal del cliente y las llamadas de otros subprocesos se serializarán en este subproceso. En la lista siguiente se muestran los valores válidos:

Apartment, Free, Both y Neutral.
tlbid Opcional. GUID de la biblioteca de tipos para este componente COM.
progid Opcional. Identificador de programación dependiente de la versión asociado al componente COM. El formato de un ProgID es <vendor>.<component>.<version>.
miscStatus Opcional. Duplica en el manifiesto del ensamblado la información proporcionada por la clave del Registro MiscStatus. Si no se encuentran los valores de los atributos miscStatusIcon, miscStatusContent, miscStatusDocprinto miscStatusThumbnail, se usa el valor predeterminado correspondiente enumerado en miscStatus para los atributos que faltan. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere MiscStatus valores de clave del Registro.
miscStatusIcon Opcional. Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_ICON. Puede proporcionar un icono de un objeto. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere Miscstatus valores de clave del Registro.
miscStatusContent Opcional. Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_CONTENT. Puede proporcionar un documento compuesto que se pueda mostrar para una pantalla o impresora. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere MiscStatus valores de clave del Registro.
miscStatusDocPrint Opcional. Duplica en el manifiesto del ensamblado la información proporcionada por DVASPECT_DOCPRINT. Puede proporcionar una representación de objeto que se puede mostrar en la pantalla como si se imprimiera en una impresora. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere MiscStatus valores de clave del Registro.
miscStatusThumbnail Opcional. Duplica en un manifiesto de ensamblado la información proporcionada por DVASPECT_THUMBNAIL. Puede proporcionar una miniatura de un objeto que se puede mostrar en una herramienta de exploración. El valor puede ser una lista delimitada por comas de los valores de atributo de la tabla siguiente. Puede usar este atributo si la clase COM es una clase OCX que requiere MiscStatus valores de clave del Registro.

comInterfaceExternalProxyStub

El elemento comInterfaceExternalProxyStub es un elemento secundario opcional del elemento file, pero puede ser necesario si la aplicación ClickOnce contiene un componente COM que pretende implementar mediante COM sin registro. El elemento contiene los siguientes atributos.

Atributo Descripción
iid Necesario. Identificador de interfaz (IID) que sirve este proxy. El IID debe tener llaves que lo rodean.
baseInterface Opcional. El IID de la interfaz desde la que se deriva la interfaz a la que hace referencia iid.
numMethods Opcional. Número de métodos implementados por la interfaz.
name Opcional. El nombre de la interfaz tal y como aparecerá en el código.
tlbid Opcional. Biblioteca de tipos que contiene la descripción de la interfaz especificada por el atributo iid.
proxyStubClass32 Opcional. Asigna un IID a un CLSID en archivos DLL de proxy de 32 bits.

comInterfaceProxyStub

El elemento comInterfaceProxyStub es un elemento secundario opcional del elemento file, pero puede ser necesario si la aplicación ClickOnce contiene un componente COM que pretende implementar mediante COM sin registro. El elemento contiene los siguientes atributos.

Atributo Descripción
iid Necesario. Identificador de interfaz (IID) que sirve este proxy. El IID debe tener llaves que lo rodean.
baseInterface Opcional. El IID de la interfaz desde la que se deriva la interfaz a la que hace referencia iid.
numMethods Opcional. Número de métodos implementados por la interfaz.
Name Opcional. El nombre de la interfaz tal y como aparecerá en el código.
Tlbid Opcional. Biblioteca de tipos que contiene la descripción de la interfaz especificada por el atributo iid.
proxyStubClass32 Opcional. Asigna un IID a un CLSID en archivos DLL de proxy de 32 bits.
threadingModel Opcional. Opcional. El modelo de subprocesos utilizado por las clases COM en proceso. Si esta propiedad es null, no se usa ningún modelo de subprocesos. El componente se crea en el subproceso principal del cliente y las llamadas de otros subprocesos se serializarán en este subproceso. En la lista siguiente se muestran los valores válidos:

Apartment, Free, Both y Neutral.

windowClass

El elemento windowClass es un elemento secundario opcional del elemento file, pero puede ser necesario si la aplicación ClickOnce contiene un componente COM que pretende implementar mediante COM sin registro. El elemento hace referencia a una clase de ventana definida por el componente COM que debe tener aplicada una versión. El elemento contiene los siguientes atributos.

Atributo Descripción
versioned Opcional. Controla si el nombre de la clase de ventana interna utilizado en el registro contiene la versión del ensamblado que contiene la clase de ventana. El valor de este atributo puede ser yes o no. De manera predeterminada, es yes. El valor no solo se debe usar si la misma clase de ventana se define mediante un componente en paralelo y un componente no en paralelo equivalente y quiere tratarlos como la misma clase de ventana. Tenga en cuenta que se aplican las reglas habituales sobre el registro de clases de ventana: solo el primer componente que registra la clase de ventana podrá registrarla, ya que no tiene una versión aplicada.

hash

El elemento hash es un elemento secundario opcional del elemento file. El elemento hash no tiene atributos.

ClickOnce usa un hash algorítmico de todos los archivos de una aplicación como comprobación de seguridad para asegurarse de que ninguno de los archivos se ha cambiado después de la implementación. Si el elemento hash no está incluido, no se realizará esta comprobación. Por tanto, no se recomienda omitir el elemento hash.

Si un manifiesto contiene un archivo que no tiene hash, ese manifiesto no se puede firmar digitalmente, porque los usuarios no pueden comprobar el contenido de un archivo sin guardar en caché.

dsig:Transforms

El elemento dsig:Transforms es un elemento secundario obligatorio del elemento hash. El elemento dsig:Transforms no tiene atributos.

dsig:Transform

El elemento dsig:Transform es un elemento secundario obligatorio del elemento dsig:Transforms. El elemento dsig:Transform tiene los atributos siguientes:

Atributo Descripción
Algorithm Algoritmo utilizado para calcular el hash de este archivo. Actualmente, el único valor usado por ClickOnce es urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

El elemento dsig:DigestMethod es un elemento secundario obligatorio del elemento hash. El elemento dsig:DigestMethod tiene los atributos siguientes:

Atributo Descripción
Algorithm Algoritmo utilizado para calcular el hash de este archivo. Actualmente, el único valor usado por ClickOnce es http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

El elemento dsig:DigestValue es un elemento secundario obligatorio del elemento hash. El elemento dsig:DigestValue no tiene atributos. Su valor de texto es el hash calculado para el archivo especificado.

Comentarios

Este elemento identifica todos los archivos nonassembly que componen la aplicación y, en particular, los valores hash para la comprobación de archivos. Este elemento también puede incluir datos de aislamiento del Modelo de objetos componentes (COM) asociados al archivo. Si cambia un archivo, el archivo de manifiesto de aplicación también debe actualizarse para reflejar el cambio.

Ejemplo

En el ejemplo de código siguiente se muestran file elementos de un manifiesto de aplicación para una aplicación implementada mediante ClickOnce.

<file name="Icon.ico" size="9216">
  <hash>
    <dsig:Transforms>
      <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
    </dsig:Transforms>
    <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
    <dsig:DigestValue>lVoj+Rh6RQ/HPNLOdayQah5McrI=</dsig:DigestValue>
  </hash>
</file>

Consulte también