Lenguaje

<elemento file> (aplicación ClickOnce)

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

Sintaxis

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

Attribute Description
name Required. Identifica el nombre del archivo.
size Required. Especifica el tamaño, en bytes, del archivo.
group Opcional, si el optional atributo 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 ApplicationDeployment clase .
optional Opcional. Especifica si este archivo debe descargarse cuando la aplicación se ejecute por primera vez, o si el archivo debe residir solo en el servidor hasta que la aplicación lo solicite a petición. Si false o no está definido, el archivo se descarga cuando la aplicación se ejecuta por primera vez o se instala. Si truees , se debe especificar 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 typelib elemento 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.

Attribute Description
tlbid Required. GUID asignado a la biblioteca de tipos.
version Required. Número de versión de la biblioteca de tipos.
helpdir Required. Directorio que contiene los archivos de Ayuda del componente. Puede ser de longitud cero.
resourceid Opcional. Representación de cadena hexadecimal 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. Representación de cadena de las marcas de biblioteca de tipos para esta biblioteca de tipos. En concreto, debe ser uno de "RESTRICTED", "CONTROL", "HIDDEN" y "HASDISKIMAGE".

comClass

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

Attribute Description
clsid Required. Identificador de clase del componente COM expresado como GUID.
description Opcional. Nombre de clase.
threadingModel Opcional. Modelo de subproceso usado por 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 es ProgID<vendor>.<component>.<version>.
miscStatus Opcional. Duplica en el manifiesto del ensamblado la información proporcionada por la clave del MiscStatus Registro. Si no se encuentran valores para los miscStatusIconatributos , 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 comInterfaceExternalProxyStub elemento es un elemento secundario opcional del file elemento, pero puede ser necesario si la aplicación ClickOnce contiene un componente COM que pretende implementar mediante COM sin registro. El elemento contiene los atributos siguientes.

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

comInterfaceProxyStub

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

Attribute Description
iid Required. Identificador de interfaz (IID) que sirve este proxy. El IID debe tener llaves que lo rodean.
baseInterface Opcional. IID de la interfaz desde la que se deriva la interfaz a la que se hace iid referencia.
numMethods Opcional. Número de métodos implementados por la interfaz.
Name Opcional. Nombre de la interfaz tal como aparecerá en el código.
Tlbid Opcional. Biblioteca de tipos que contiene la descripción de la interfaz especificada por el iid atributo .
proxyStubClass32 Opcional. Asigna un IID a un CLSID en archivos DLL de proxy de 32 bits.
threadingModel Opcional. Opcional. Modelo de subproceso usado por 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 windowClass elemento es un elemento secundario opcional del file elemento, 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 atributos siguientes.

Attribute Description
versioned Opcional. Controla si el nombre de clase de ventana interno usado 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. El valor predeterminado es yes. El valor no solo debe usarse si la misma clase de ventana se define mediante un componente en paralelo y un componente equivalente que no es en paralelo y desea 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 a ella.

hash

El hash elemento es un elemento secundario opcional del file elemento. El hash elemento 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 cambió después de la implementación. Si el hash elemento no está incluido, esta comprobación no se realizará. Por lo tanto, no se recomienda omitir el hash elemento.

Si un manifiesto contiene un archivo que no está hash, ese manifiesto no se puede firmar digitalmente, ya que los usuarios no pueden comprobar el contenido de un archivo no guardado.

dsig:Transforms

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

dsig:Transform

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

Attribute Description
Algorithm Algoritmo usado para calcular el resumen de este archivo. Actualmente, el único valor usado por ClickOnce es urn:schemas-microsoft-com:HashTransforms.Identity.

dsig:DigestMethod

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

Attribute Description
Algorithm Algoritmo usado para calcular el resumen de este archivo. Actualmente, el único valor usado por ClickOnce es http://www.w3.org/2000/09/xmldsig#sha1.

dsig:DigestValue

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

Observaciones

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.

Example

En el ejemplo de código siguiente se muestran file los 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>

Véase también

  • Last updated on