ResolveAssemblyReference (Tarea)
Actualización: Julio de 2008
Determina todos los ensamblados que dependen de ensamblados especificados. Esto incluye dependencias de segundo y n-ésimo orden.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea ResolveAssemblyReference.
Parámetro |
Descripción |
---|---|
AllowedAssemblyExtensions |
Parámetro String[] opcional. Las extensiones de nombre de archivo de ensamblado que se utilizan al resolver las referencias. Las extensiones de nombre de archivo predeterminadas son .exe y .dll. |
AllowedRelatedFileExtensions |
Parámetro String[] opcional. Las extensiones de nombre de archivo que se utilizan para una búsqueda de archivos relacionados entre sí. Las extensiones predeterminadas son .pdb y .xml. |
AppConfigFile |
Parámetro String opcional. Especifica un archivo app.config del que analizar y extraer las asignaciones de bindingRedirect. Si se especifica este parámetro, el valor del parámetro AutoUnify deberá ser false. |
Assemblies |
Parámetro ITaskItem[] opcional. Especifica los elementos para los que se deben identificar las rutas de acceso completas y las dependencias. Estos elementos pueden tener cualquier nombre simple como "Sistema" o nombres seguros como "Sistema, Versión=2.0.3500.0, Referencia cultural=neutral, PublicKeyToken=b77a5c561934e089." Los elementos que se hayan pasado a este parámetro pueden incluir opcionalmente los siguientes metadatos de elemento:
|
AssemblyFiles |
Parámetro ITaskItem[] opcional. Especifica una lista de rutas de acceso completas a ensamblados para los que deben buscarse dependencias. Los elementos que se hayan pasado a este parámetro pueden incluir opcionalmente los siguientes metadatos de elemento:
|
AutoUnify |
Parámetro Boolean opcional. Si es true, el gráfico de dependencia resultante se trata automáticamente como si se hubiese pasado un archivo App.Config al parámetro AppConfigFile. Este archivo App.Config virtual dispone de una entrada bindingRedirect para cada conjunto de ensamblados en conflicto de modo que se elige el ensamblado de versión superior. Como consecuencia, nunca se emitirá ninguna advertencia sobre ensamblados en conflicto, puesto que se habrán resuelto todos. Las distintas reasignaciones darán lugar a comentarios de alta prioridad donde se indiquen las versiones anteriores y las nuevas versiones, así como el hecho de que la operación se ha realizado automáticamente porque el parámetro AutoUnify era true. Si es false, no se realizará ninguna reasignación de versiones de ensamblado de forma automática. Cuando haya dos versiones de un mismo ensamblado, se emitirá una advertencia. Los distintos conflictos que se produzcan entre versiones diferentes del mismo ensamblado darán lugar a comentarios de alta prioridad. Una vez que se hayan mostrado todos estos comentarios, se emitirá una única advertencia con un código de error único y un texto como el siguiente: "Se encontraron conflictos entre diferentes versiones de ensamblados de referencia y ensamblados dependientes". El valor predeterminado es false. |
CandidateAssemblyFiles |
Parámetro String[] opcional. Especifica una lista de ensamblados que deben utilizarse en el proceso de búsqueda y resolución. Los valores que se hayan pasado a este parámetro deberán ser nombres de archivo absolutos o nombres de archivo relativos al proyecto. Los ensamblados de esta lista se tendrán en consideración cuando el parámetro SearchPaths contenga {CandidateAssemblyFiles} como una de las rutas de acceso que deben considerarse. |
CopyLocalFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Devuelve todos los archivos de los parámetros ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles y ScatterFiles que incluyan metadatos del elemento CopyLocal con un valor true. |
FilesWritten |
Parámetro de salida ITaskItem[] opcional. Contiene los elementos escritos en el disco. |
FindDependencies |
Parámetro Boolean opcional. Si es true, se buscarán dependencias. De lo contrario, sólo se buscarán referencias primarias. El valor predeterminado es true. |
FindRelatedFiles |
Parámetro Boolean opcional. Si es true, se buscarán archivos relacionados como, por ejemplo, archivos .pdb y archivos .xml. El valor predeterminado es true. |
FindSatellites |
Parámetro Boolean opcional. Si es true, se buscarán ensamblados satélite. El valor predeterminado es true.. |
FindSerializationAssemblies |
Parámetro Boolean opcional. Si es true, la tarea busca los ensamblados de serialización. El valor predeterminado es true. |
FullTargetFrameworkSubsetNames |
Parámetro String[] opcional. Contiene una lista de nombres del subconjunto de la versión de .NET Framework de destino. Si un nombre del subconjunto de la lista coincide con uno de la propiedad de nombre TargetFrameworkSubset, el sistema excluye ese subconjunto de la versión de .NET Framework de destino en tiempo de compilación. |
IgnoreDefaultInstalledAssemblyTables |
Parámetro Boolean opcional. Si true, la tarea busca y utiliza tablas de ensamblados instalados adicionales (o "Redist Lists") que se encuentran en el directorio \RedistList bajo TargetFrameworkDirectories. El valor predeterminado es false.. |
IgnoreDefaultInstalledAssemblySubsetTables |
Parámetro Boolean opcional. Si true, la tarea busca y utiliza tablas de subconjuntos instalados adicionales (o "Subset Lists") que se encuentran en el directorio \SubsetList, bajo TargetFrameworkDirectories. El valor predeterminado es false.. |
InstalledAssemblySubsetTables |
Parámetro ITaskItem[] opcional. Contiene una lista de archivos XML que especifican los ensamblados que se espera que estén en el subconjunto de destino. Como una opción, los elementos de esta lista pueden especificar los metadatos de "FrameworkDirectory" para asociar un InstalledAssemblySubsetTable con un directorio de .NET Framework determinado. Si solo hay un elemento TargetFrameworkDirectories, cualquier elemento de esta lista que no tenga los metadatos de "FrameworkDirectory" se trata como si estuviera establecidos en el único valor que se pasa a TargetFrameworkDirectories. |
InstalledAssemblyTables |
Parámetro String opcional. Contiene una lista de archivos XML que especifican los ensamblados que se espera que estén instalados en el equipo de destino. Cuando se establece InstalledAssemblyTables, las versiones anteriores de los ensamblados de la lista se combinan en las versiones más recientes que se enumeran en el XML. Asimismo, los ensamblados que tienen un valor InGAC='true' se consideran requisitos previos y se establecen en CopyLocal='false', a menos que se invaliden explícitamente. Como opción, los elementos de esta lista pueden especificar los metadatos de "FrameworkDirectory" para asociar un InstalledAssemblyTable a un directorio de .NET Framework determinado. Sin embargo, este valor se omite a menos que Redist comience por "Microsoft-Windows-CLRCoreComp". Si solo hay un elemento TargetFrameworkDirectories, cualquier elemento de esta lista que no tenga los metadatos de "FrameworkDirectory" se trata como si estuviera establecido en el único valor que se pasa a TargetFrameworkDirectories. |
RelatedFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Contiene archivos relacionados como, por ejemplo, archivos XML y archivos .pdb, con el mismo nombre base como referencia. Los archivos enumerados en este parámetro pueden contener opcionalmente los metadatos del elemento siguientes:
|
ResolvedDependencyFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Contiene las rutas de acceso de -ésimo orden a las dependencias. Este parámetro no contiene referencias principales de primer orden; éstas se incluyen en el parámetro ResolvedFiles. Los elementos de este parámetro contienen opcionalmente los siguientes metadatos de elemento:
|
ResolvedFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Contiene una lista de todas las referencias principales que se han resuelto en rutas de acceso completas. Los elementos de este parámetro contienen opcionalmente los siguientes metadatos de elemento:
|
SatelliteFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Especifica los archivos satélite encontrados. Serán CopyLocal=true si la referencia o dependencia que ha originado este elemento es CopyLocal=true. Los elementos de este parámetro contienen opcionalmente los siguientes metadatos de elemento:
|
ScatterFiles |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Contiene los archivos de dispersión asociados a uno de los ensamblados indicados. Los elementos de este parámetro contienen opcionalmente los siguientes metadatos de elemento:
|
SearchPaths |
Parámetro String[] requerido. Especifica los directorios o ubicaciones especiales donde deben buscarse los archivos en disco que representan los ensamblados. El orden en que se muestran las rutas de búsqueda es importante. Para cada ensamblado, se realiza una búsqueda de izquierda a derecha en la lista de rutas de acceso. Cuando se encuentra un archivo que representa al ensamblado, la búsqueda actual se detiene y se inicia la búsqueda del siguiente ensamblado. Este parámetro acepta los siguientes tipos de valores:
|
Silent |
Parámetro Boolean opcional. Si es true, no se registra ningún mensaje. El valor predeterminado es false. |
StateFile |
Parámetro String opcional. Especifica un nombre de archivo que indica dónde debe guardarse el estado de compilación intermedio de esta tarea. |
SuggestedRedirects |
Parámetro de salida de sólo lectura ITaskItem[] opcional. Contiene un elemento para cada una de las distintas identidades de ensamblados en conflicto, independientemente del valor del parámetro AutoUnify. Se incluyen las referencias culturales y PKT encontrados que no dispongan de una entrada bindingRedirect apropiada en el archivo de configuración de la aplicación. Cada elemento contiene opcionalmente la siguiente información:
|
TargetFrameworkDirectories |
Parámetro String[] opcional. Especifica la ruta de acceso del directorio de la versión de :NET Framework de destino. Este parámetro es necesario para poder determinar el estado de CopyLocal de los elementos resultantes. Si no se especifica este parámetro, ninguno de los elementos resultantes tendrá un valor true para CopyLocal, a menos que el valor de los metadatos Private sea explícitamente true en su elemento origen. |
TargetFrameworkSubsets |
Parámetro String[] opcional. Contiene una lista de nombres del subconjunto de la versión .NET Framework de destino que se va a buscar en los directorios de la versión de .NET Framework de destino. |
TargetFrameworkVersion |
Parámetro String opcional. La versión de .NET Framework de destino del proyecto. El valor predeterminado está vacío, lo que significa no hay ningún filtrado para las referencias basadas en la versión de .NET Framework de destino. |
TargetProcessorArchitecture |
Parámetro String opcional. Arquitectura preferida del procesador de destino. Se utiliza para resolver referencias de la Caché de ensamblados global (GAC). El valor de este parámetro puede ser x86, IA64 o AMD64. Si no está este parámetro, la tarea considera en primer lugar los ensamblados que coinciden con la arquitectura del proceso que se está ejecutando. Si no se encuentra ningún ensamblado, la tarea considera los ensamblados de GAC con un valor ProcessorArchitecture de MSIL o sin valor ProcessorArchitecture. |
Vea también
Conceptos
Otros recursos
Referencia de tareas de MSBuild
Historial de cambios
Fecha |
Historial |
Motivo |
---|---|---|
Julio de 2008 |
Se han agregado estos parámetros:
|
Cambio de características de SP1. |