Archivos de configuración de la aplicación

Un archivo de configuración de aplicación es un archivo XML que se usa para controlar el enlace de ensamblados. Puede redirigir una aplicación desde una versión de un ensamblado en paralelo a otra versión del mismo ensamblado. Esto se denomina configuración por aplicación. Un archivo de configuración de aplicación solo se aplica a un manifiesto de aplicación específico y a ensamblados dependientes. Los componentes aislados compilados con un manifiesto de ISOLATIONAWARE_MANIFEST_RESOURCE_ID incrustado requieren un archivo de configuración de aplicación independiente. Los manifiestos administrados con CreateActCtx requieren un archivo de configuración de aplicación independiente.

El redireccionamiento especificado por un archivo de configuración de aplicación puede invalidar las versiones de ensamblado especificadas por los manifiestos de aplicación y los archivos de configuración del publicador. Por ejemplo, si un archivo de configuración del publicador especifica que todas las referencias a un ensamblado se redirigen de la versión 1.0.0.0 a 1.1.0.0, se puede usar un archivo de configuración de aplicación para redirigir una aplicación determinada para que use la versión 1.0.0.0. Un archivo de configuración de aplicación solo se aplica al manifiesto de aplicación especificado y a los ensamblados dependientes.

Para obtener una lista completa del esquema XML, vea Esquema de archivo de configuración de aplicaciones.

Los archivos de configuración de la aplicación tienen los elementos y atributos que se muestran en la tabla siguiente.

Ubicación del archivo

Los archivos de configuración de la aplicación deben instalarse en la misma ubicación que el manifiesto de aplicación de la aplicación.

Sintaxis de los nombres de archivo

El nombre de un archivo de configuración de aplicación es el nombre del ejecutable de la aplicación seguido de .config.

Por ejemplo, un archivo de configuración de aplicación que hace referencia a Example.exe o Example.dll usaría la sintaxis del nombre de archivo que se muestra en el ejemplo siguiente. Puede omitir el campo del <identificador> de recurso si instala el archivo de configuración como un archivo independiente o si el identificador de recurso es 1.

example.exe.<identificador de> recurso.config

example.dll.<identificador de> recurso.config

Elementos

Los nombres de los elementos y atributos distinguen mayúsculas de minúsculas. Los valores de los elementos y atributos no distinguen mayúsculas de minúsculas, excepto el valor del atributo de tipo.

configuración

Elemento contenedor para los elementos windows y runtime de un archivo de configuración de aplicación. Necesario.

Windows

Incluye las partes del archivo de configuración de la aplicación que se aplican al redireccionamiento de ensamblados Win32.

publisherPolicy

Especifica si se va a aplicar la directiva de publicador.

Este elemento tiene los atributos que se muestran en la tabla siguiente.

motor en tiempo de ejecución

Incluye las partes del archivo de configuración de la aplicación que se aplican al redireccionamiento de ensamblados .Net.

assemblyBinding

Incluye la información de redireccionamiento de la aplicación y el ensamblado afectados por este archivo de configuración de la aplicación. El primer subelemento de assemblyBinding debe ser un assemblyIdentity que identifique la aplicación.

A partir de Windows Server 2008 R2 y Windows 7, un elemento assemblyBinding puede incluir un subelemento de sondeo .

buscar

Un subelemento opcional de un elemento assemblyBinding que extiende la búsqueda de ensamblados en directorios adicionales. No es necesario que los directorios adicionales sean subdirectorios del directorio del ensamblado.

Este elemento tiene los atributos que se muestran en la tabla siguiente.

Puede usar el especificador especial de puntos dobles en una ruta de acceso para indicar el directorio primario del directorio actual. No se pueden especificar más de dos niveles por encima del directorio actual mediante puntos dobles. No use puntos triples. Por ejemplo, una aplicación que usa el siguiente elemento de sondeo comprueba directorios adicionales para un ensamblado.

<probing privatePath="bin;..\bin2\subbin;bin3"/>

dependency

Elemento contenedor para al menos un elemento dependentAssembly. Cada dependentAssembly puede estar dentro exactamente de una dependencia. Este elemento no tiene atributos. Opcional.

dependentAssembly

El primer subelemento debe ser un elemento assemblyIdentity que identifique el ensamblado en paralelo que redirige el archivo de configuración de la aplicación. Un elemento dependentAssembly no tiene atributos.

assemblyIdentity

Como primer subelemento de un elemento assemblyBinding , assemblyIdentity describe e identifica de forma única una aplicación. El archivo de configuración de la aplicación redirige el enlace de esta aplicación a ensamblados en paralelo. Por ejemplo, assemblyIdentity siguiente indica que el archivo de configuración de la aplicación afecta al enlace de la aplicación mysampleApp a ensamblados en paralelo. Los ensamblados que se redirigen se identificarían en un elemento dependentAssembly.

<assemblyIdentity processorArchitecture="X86" name="Microsoft.Windows.mysampleApp" type="win32" version="1.0.0.0"/>

Como primer subelemento de un elemento dependentAssembly , assemblyIdentity describe un ensamblado en paralelo en el que depende la aplicación. El archivo de configuración de la aplicación vuelve a configurar la identidad de este ensamblado necesario. Por ejemplo, el siguiente assemblyIdentity y bindingRedirect vuelve a configurar una dependencia en Microsoft.Windows.SampleAssembly de la versión 2.0.0.0 a la versión 2.1.0.0.

<dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32"
          name="Microsoft.Windows.SampleAssembly"
          processorArchitecture="x86"
          publicKeyToken="0000000000000000"/>
         <bindingRedirect oldVersion="2.0.0.0" newVersion="2.1.0.0"/>
      </dependentAssembly>
</dependency>

Tenga en cuenta que cada assemblyIdentity incluido en un elemento dependentAssembly debe coincidir exactamente con assemblyIdentity en el propio manifiesto de ensamblado del ensamblado.

El elemento assemblyIdentity tiene los atributos siguientes. No tiene subelementos.

bindingRedirect

El elemento bindingRedirect contiene información de redireccionamiento para el enlace del ensamblado. Cada bindingRedirect debe incluirse exactamente en un elemento dependentAssembly. La sintaxis de la versión de cuatro partes de la nueva versión y la versión anterior deben especificar las mismas versiones principales y secundarias.

Este elemento tiene los atributos que se muestran en la tabla siguiente.

Comentarios

Los archivos de configuración de la aplicación no especifican archivos.

Ejemplo

<bindingRedirect oldVersion="1.0.0.0" newVersion="1.0.10.0"/>
<bindingRedirect oldVersion="1.0.50.2011-1.0.60.65535" newVersion="1.0.70.0"/>