ResolveAssemblyReference (Tarea)ResolveAssemblyReference Task

Determina todos los ensamblados que dependen de los ensamblados especificados.Determines all assemblies that depend on the specified assemblies. Esto incluye las dependencias segundo y de nº orden.This includes second and nth-order dependencies.

ParámetrosParameters

En la siguiente tabla se describen los parámetros de la tarea ResolveAssemblyReference .The following table describes the parameters of the ResolveAssemblyReference task.

ParámetroParameter DescriptionDescription
AllowedAssemblyExtensions Parámetro String[] opcional.Optional String[] parameter.

Las extensiones de nombre de archivo de ensamblado que se usarán al resolver referencias.The assembly file name extensions to use when resolving references. Las extensiones de nombre de archivo predeterminadas son .exe y .dll.The default file name extensions are .exe and .dll.
AllowedRelatedFileExtensions Parámetro String[] opcional.Optional String[] parameter.

Las extensiones de nombre de archivo que se usarán para buscar archivos relacionados entre sí.The file name extensions to use for a search for files that are related to one another. Las extensiones predeterminadas son .pdb y .xml.The default extensions are .pdb and .xml.
AppConfigFile Parámetro String opcional.Optional String parameter.

Especifica un archivo app.config del que se analizarán y extraerán asignaciones de bindingRedirect.Specifies an app.config file from which to parse and extract bindingRedirect mappings. Si se especifica este parámetro, el parámetro AutoUnify debe ser false.If this parameter is specified, the AutoUnify parameter must be false.
AutoUnify Parámetro Boolean opcional.Optional Boolean parameter.

Este parámetro se usa para crear ensamblados, como archivos DLL, que no pueden tener un archivo App.Config normal.This parameter is used for building assemblies, such as DLLs, which cannot have a normal App.Config file.

Cuando es true, el gráfico de dependencias resultante se trata automáticamente como si hubiera un archivo App.Config que se pasa al parámetro AppConfigFile.When true, the resulting dependency graph is automatically treated as if there were anApp.Config file passed in to the AppConfigFile parameter. Este archivo App.Config virtual tiene una entrada bindingRedirect para cada conjunto de ensamblados en conflicto de manera que se elige el ensamblado de la versión superior.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies such that the highest version assembly is chosen. Una consecuencia de esto es que nunca habrá una advertencia sobre los ensamblados en conflicto porque todos los conflictos se habrán resuelto.A consequence of this is that there will never be a warning about conflicting assemblies because every conflict will have been resolved.

Cuando es true, cada reasignación distinta dará lugar a un comentario de alta prioridad que muestre las versiones anteriores y las nuevas y que AutoUnify era true.When true, each distinct remapping will result in a high priority comment showing the old and new versions and that AutoUnify was true.

Cuando es true, el parámetro AppConfigFile debe estar vacío.When true, the AppConfigFile parameter must be empty

Cuando es false, no se producirá automáticamente ninguna reasignación de versiones de ensamblado.When false, no assembly version remapping will occur automatically. Cuando haya dos versiones de un ensamblado, se emitirá una advertencia.When two versions of an assembly are present, a warning is issued.

Cuando es false, cada conflicto distinto entre versiones diferentes del mismo ensamblado da como resultado un comentario de alta prioridad.When false, each distinct conflict between different versions of the same assembly results in a high-priority comment. Estos comentarios van seguidos de una única advertencia.These comments are followed by a single warning. La advertencia tiene un código de error único y contiene texto que indica que se encontraron conflictos entre diferentes versiones de referencia y ensamblados dependientes.The warning has a unique error code and contains text that reads "Found conflicts between different versions of reference and dependent assemblies".
Assemblies Parámetro ITaskItem[] opcional.Optional ITaskItem[] parameter.

Especifica los elementos para los que se deben identificar las dependencias y las rutas de acceso completas.Specifies the items for which full paths and dependencies must be identified. Estos elementos pueden tener nombres sencillos como "System" o nombres seguros como "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089."These items can have either simple names like "System" or strong names like "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089."

Los elementos pasados a este parámetro podrían tener opcionalmente los siguientes metadatos de elemento:Items passed to this parameter may optionally have the following item metadata:

- Private: valor Boolean .- Private: Boolean value. Si es true, el elemento se copia localmente.If true, then the item is copied locally. El valor predeterminado es true.The default value is true.
- HintPath: valor String .- HintPath: String value. Especifica el nombre y la ruta de acceso que se usarán como referencia.Specifies the path and file name to use as a reference. Se usa cuando se especifica {HintPathFromItem} en el parámetro SearchPaths .This is used when {HintPathFromItem} is specified in the SearchPaths parameter. El valor predeterminado es una cadena vacía.The default value is an empty string.
- SpecificVersion: valor Boolean .- SpecificVersion: Boolean value. Si es true, debe coincidir el nombre exacto especificado en el atributo Include .If true, then the exact name specified in the Include attribute must match. Si es false, funcionará cualquier ensamblado con el mismo nombre simple.If false, then any assembly with the same simple name will work. Si no se especifica SpecificVersion , la tarea examinará el valor del atributo Include del elemento.If SpecificVersion is not specified, then the task examines the value in the Include attribute of the item. Si el atributo es un nombre sencillo, se comporta como si SpecificVersion era false.If the attribute is a simple name, it behaves as if SpecificVersion was false. Si el atributo es un nombre seguro, se comporta como si SpecificVersion era true.If the attribute is a strong name, it behaves as if SpecificVersion was true.
Cuando se usa con un tipo de elemento de referencia, el atributo Include debe ser el nombre de fusión completo del ensamblado que se va a resolver.When used with a Reference item type, the Include attribute needs to be the full fusion name of the assembly to be resolved. El ensamblado solo se resuelve si la fusión coincide exactamente con el atributo Include .The assembly is only resolved if fusion exactly matches the Include attribute.
Cuando un proyecto tiene como destino una versión de .NET Framework y hace referencia a un ensamblado compilado para una versión posterior de .NET Framework, la referencia solo resuelve si tiene SpecificVersion establecido en true.When a project targets a .NET Framework version and references an assembly compiled for a higher .NET Framework version, the reference resolves only if it has SpecificVersion set to true.
Cuando un proyecto tiene como destino un perfil y hace referencia a un ensamblado que no está en el perfil, la referencia solo resuelve si tiene SpecificVersion establecido en true.When a project targets a profile and references an assembly that is not in the profile, the reference resolves only if it has SpecificVersion set to true.
- ExecutableExtension: valor String .- ExecutableExtension: String value. Cuando está presente, el ensamblado resuelto debe tener esta extensión.When present, the resolved assembly must have this extension. Cuando está ausente, la .dll se considera en primer lugar, seguida del .exe, para cada directorio examinado.When absent, .dll is considered first, followed by .exe, for each examined directory.
- SubType: valor String .- SubType: String value. Solo los elementos con metadatos SubType vacíos se resolverán en rutas de acceso de ensamblado completas.Only items with empty SubType metadata will be resolved into full assembly paths. Se ignoran los elementos con metadatos SubType no vacíos.Items with non-empty SubType metadata are ignored.
- AssemblyFolderKey: valor String .- AssemblyFolderKey: String value. Estos metadatos se admiten para fines de herencia.This metadata is supported for legacy purposes. Especifica una clave del Registro definida por el usuario, como "hklm\VendorFolder", que Assemblies debe usar para resolver las referencias de ensamblado.It specifies a user-defined registry key, such as "hklm\VendorFolder", that Assemblies should use to resolve assembly references.
AssemblyFiles Parámetro ITaskItem[] opcional.Optional ITaskItem[] parameter.

Especifica una lista de ensamblados completa para los que se buscarán dependencias.Specifies a list of fully qualified assemblies for which to find dependencies.

Los elementos pasados a este parámetro podrían tener opcionalmente los siguientes metadatos de elemento:Items passed to this parameter may optionally have the following item metadata:

- Private: valor Boolean opcional.- Private: an optional Boolean value. Si es true, el elemento se copia localmente.If true, the item is copied locally.
- FusionName: metadatos String opcionales.- FusionName: optional String metadata. Especifica el nombre sencillo o seguro de este elemento.Specifies the simple or strong name for this item. Si este atributo está presente se ahorra tiempo, ya que no es necesario abrir el archivo de ensamblado para obtener el nombre.If this attribute is present, it can save time because the assembly file does not have to be opened to get the name.
AutoUnify Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, el gráfico de dependencias resultante se trata automáticamente como si hubiera un archivo App.Config que se pasa al parámetro AppConfigFile.If true, the resulting dependency graph is automatically treated as if there were an App.Config file passed in to the AppConfigFile parameter. Este archivo App.Config virtual tiene una entrada bindingRedirect para cada conjunto de ensamblados en conflicto de manera que se elige el ensamblado de la versión superior.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies so that the highest version assembly is chosen. Una consecuencia de esto es que nunca habrá una advertencia sobre los ensamblados en conflicto porque todos los conflictos se habrán resuelto.A result of this is that there will never be a warning about conflicting assemblies because every conflict will have been resolved. Cada reasignación distinta producirá un comentario de alta prioridad que indique la versiones anteriores y las nuevas, y el hecho de que esto se realizara automáticamente porque AutoUnify era true.Each distinct remapping will cause a high priority comment that indicates the old and new versions and the fact that this was done automatically because AutoUnify was true.

Si es false, no se producirá automáticamente ninguna reasignación de versiones de ensamblado.If false, no assembly version remapping will occur automatically. Cuando haya dos versiones de un ensamblado, se producirá una advertencia.When two versions of an assembly are present, there will be a warning. Cada conflicto distinto entre diferentes versiones del mismo ensamblado producirá un comentario de alta prioridad.Each distinct conflict between different versions of the same assembly will cause a high priority comment. Cuando se muestren todos estos comentarios, se producirá una advertencia única con un código de error único y texto que indique que se encontraron conflictos entre diferentes versiones de referencia y ensamblados dependientes.After all these comments are displayed, there will be a single warning with a unique error code and text that reads "Found conflicts between different versions of reference and dependent assemblies".

El valor predeterminado es false.The default value is false.
CandidateAssemblyFiles Parámetro String[] opcional.Optional String[] parameter.

Especifica una lista de ensamblados que se usará para el proceso de búsqueda y resolución.Specifies a list of assemblies to use for the search and resolution process. Los valores pasados a este parámetro deben ser nombres de archivo absolutos o nombres de archivo relativos al proyecto.Values passed to this parameter must be absolute file names or project-relative file names.

Los ensamblados de esta lista se considerarán cuando el parámetro SearchPaths contenga {CandidateAssemblyFiles} como una de las rutas de acceso que hay que tener en cuenta.Assemblies in this list will be considered when the SearchPaths parameter contains {CandidateAssemblyFiles} as one of the paths to consider.
CopyLocalDependenciesWhenParentReferenceInGac Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, para determinar si una dependencia se debe copiar localmente, una de las comprobaciones realizadas es ver si la referencia primaria del archivo de proyecto tiene establecidos los metadatos privados.If true, to determine if a dependency should be copied locally, one of the checks done is to see if the parent reference in the project file has the Private metadata set. Si es así, el valor Private se usará como dependencia.If set, then the Private value is used as a dependency.

Si no se establecen los metadatos, la dependencia pasa por las mismas comprobaciones que la referencia primaria.If the metadata is not set, then the dependency goes through the same checks as the parent reference. Una de estas comprobaciones consiste en ver si la referencia está en la GAC.One of these checks is to see if the reference is in the GAC. Si hay una referencia en la GAC, no se copia localmente, porque se supone que se encuentra en la GAC del equipo de destino.If a reference is in the GAC, then it is not copied locally, because it is assumed to be in the GAC on the target machine. Esto solo se aplica a una referencia concreta y no a sus dependencias.This only applies to a specific reference and not its dependencies.

Por ejemplo, no se copia localmente una referencia del archivo de proyecto que se encuentra en la GAC, pero sus dependencias se copian localmente porque no se encuentran en la GAC.For example, a reference in the project file that is in the GAC is not copied locally, but its dependencies are copied locally because they are not in the GAC.

Si es false, se comprueban las referencias del archivo de proyecto para ver si se encuentran en la GAC, y se copian localmente según corresponda.If false, project file references are checked to see if they are in the GAC, and are copied locally as appropriate.

Las dependencias se comprueban para ver si se encuentran en la GAC y también se comprueban para ver si la referencia primaria del archivo del proyecto se encuentra en la GAC.Dependencies are checked to see if they are in the GAC and are also checked to see if the parent reference from the project file is in the GAC.

Si la referencia primaria del archivo del proyecto se encuentra en la GAC, la dependencia no se copia localmente.If the parent reference from the project file is in the GAC, the dependency is not copied locally.

Si este parámetro es true o false, si hay varias referencias primarias y alguna de ellas no se encuentra en la GAC, todas ellas se copiarán localmente.Whether this parameter is true or false, if there are multiple parent references and any of them are not in the GAC, then all of them are copied locally.
CopyLocalFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Devuelve todos los archivos de los parámetros ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFilesy ScatterFiles que tienen metadatos de elementos CopyLocal con un valor de true.Returns every file in the ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, and ScatterFiles parameters that has CopyLocal item metadata with a value of true.
FilesWritten Parámetro de salida ITaskItem[] opcional.Optional ITaskItem[] output parameter.

Contiene los elementos escritos en el disco.Contains the items written to disk.
FindDependencies Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, se encontrarán dependencias.If true, dependencies will be found. De lo contrario, solo se encuentran referencias principales.Otherwise, only primary references are found. El valor predeterminado es true.The default value is true.
FindRelatedFiles Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, se encontrarán los archivos relacionados, como los archivos .pdb y .xml.If true, related files such as .pdb files and .xml files will be found. El valor predeterminado es true.The default value is true.
FindSatellites Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, se encontrarán los ensamblados satélite.If true, satellite assemblies will be found. El valor predeterminado es true.The default value is true.
FindSerializationAssemblies Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, la tarea busca los ensamblados de serialización.If true, then the task searches for serialization assemblies. El valor predeterminado es true.The default value is true.
FullFrameworkAssemblyTables Parámetro ITaskItem[] opcional.Optional ITaskItem[] parameter.

Especifica elementos que tengan metadatos "FrameworkDirectory" para asociar una lista redist a un directorio de marco de trabajo concreto.Specifies items that have "FrameworkDirectory" metadata to associate a redist list with a particular framework directory. Si no se realiza la asociación, se registrará un error.If the association is not made, an error will be logged. La lógica de resolución de referencias de ensamblado (RAR) usa el directorio del marco de trabajo de destino si no se establece FrameworkDirectory.The resolve assembly reference (RAR) logic uses the target framework directory if a FrameworkDirectory is not set..
FullFrameworkFolders Parámetro System.String[] opcional.Optional System.String[] parameter.

Especifica el conjunto de carpetas que contiene un directorio RedistList.Specifies the set of folders which contain a RedistList directory. Este directorio representa el marco de trabajo completo para un perfil de cliente determinado, por ejemplo, %programfiles%\reference assemblies\microsoft\framework\v4.0.This directory represents the full framework for a given client profile, for example, %programfiles%\reference assemblies\microsoft\framework\v4.0.
FullTargetFrameworkSubsetNames Parámetro String[] opcional.Optional String[] parameter.

Contiene una lista de nombres del subconjunto de marco de trabajo de destino.Contains a list of target framework subset names. Si un nombre del subconjunto de la lista coincide con uno de la propiedad de nombre TargetFrameworkSubset , el sistema excluye ese subconjunto de marco de trabajo de destino en tiempo de compilación.If a subset name in the list matches one in the TargetFrameworkSubset name property, then the system excludes that particular target framework subset at build time.
IgnoreDefaultInstalledAssemblyTables Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, la tarea busca y usa las tablas de ensamblados instalados adicionales (o "Listas Redist") que se encuentran en el directorio \RedistList en TargetFrameworkDirectories.If true, then the task searches for and uses additional installed assembly tables (or, "Redist Lists") that are found in the \RedistList directory under TargetFrameworkDirectories. El valor predeterminado es false.The default value is false.
IgnoreDefaultInstalledAssemblySubsetTables Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, la tarea busca y usa tablas de subconjuntos de ensamblados instalados adicionales (o "Listas de subconjuntos") que se encuentran en el directorio \SubsetList en TargetFrameworkDirectories.If true, then the task searches for and uses additional installed assembly subset tables (or, "Subset Lists") that are found in the \SubsetList directory under TargetFrameworkDirectories. El valor predeterminado es false.The default value is false.
InstalledAssemblySubsetTables Parámetro ITaskItem[] opcional.Optional ITaskItem[] parameter.

Contiene una lista de archivos XML que especifican los ensamblados que se espera que se encuentren en el subconjunto de destino.Contains a list of XML files that specify the assemblies that are expected to be in the target subset.

Como opción, los elementos de esta lista pueden especificar los metadatos "FrameworkDirectory" para asociar un elemento InstalledAssemblySubsetTableAs an option, items in this list can specify the "FrameworkDirectory" metadata to associate an InstalledAssemblySubsetTable

con un directorio de marco de trabajo concreto.with a particular framework directory.

Si solo hay un elemento TargetFrameworkDirectories , los elementos de esta lista que no tengan los metadatos "FrameworkDirectory" se tratan como si se establecieran en el valor único que se pasa a TargetFrameworkDirectories.If there is only one TargetFrameworkDirectories element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as though they are set to the unique value that is passed to TargetFrameworkDirectories.
InstalledAssemblyTables Parámetro String opcional.Optional String parameter.

Contiene una lista de archivos XML que especifican los ensamblados que se espera que estén instalados en el equipo de destino.Contains a list of XML files that specify the assemblies that are expected to be installed on the target computer.

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.When InstalledAssemblyTables is set, earlier versions of the assemblies in the list are merged into the newer versions that are listed in the XML. Asimismo, los ensamblados que tienen un valor InGAC = 'true' se consideran requisitos previos y se establecen en CopyLocal = 'false', a menos que se reemplacen explícitamente.Also, assemblies that have a setting of InGAC='true' are considered prerequisites and are set to CopyLocal='false' unless explicitly overridden.

Como opción, los elementos de esta lista pueden especificar los metadatos "FrameworkDirectory" para asociar un elemento InstalledAssemblyTable con un directorio de marco de trabajo concreto.As an option, items in this list can specify "FrameworkDirectory" metadata to associate an InstalledAssemblyTable with a particular framework directory. Sin embargo, se ignora esta configuración a menos que el nombre de Redist comience porHowever, this setting is ignored unless the Redist name begins with

"Microsoft-Windows-CLRCoreComp"."Microsoft-Windows-CLRCoreComp".

Si solo hay un elemento TargetFrameworkDirectories , los elementos de esta lista que no tengan los metadatos "FrameworkDirectory" se tratan como si se establecieran en el valor único que se pasaIf there is only one TargetFrameworkDirectories element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as if they are set to the unique value that is passed

a TargetFrameworkDirectories.to TargetFrameworkDirectories.
LatestTargetFrameworkDirectories Parámetro String[] opcional.Optional String[] parameter.

Especifica una lista de directorios que contienen las listas redist para el marco de trabajo más reciente que se puede usar como destino en la máquina.Specifies a list of directories which contain the redist lists for the most current framework which can be targeted on the machine. Si no se establece, se usa la última versión del marco de trabajo instalado en la máquina para un identificador de marco de trabajo de destino.If this is not set then the highest framework installed on the machine for a given target framework identifier is used.
ProfileName Parámetro String opcional.Optional String parameter.

- Especifica el nombre del perfil del marco que se va a tener como destino.- Specifies the name of the framework profile to be targeted. Por ejemplo, Client, Web o Network.For example, Client, Web, or Network.
RelatedFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene los archivos relacionados, como los archivos XML y .pdb que tienen el mismo nombre base como referencia.Contains related files, such as XML and .pdb files that have the same base name as a reference.

Los archivos mostrados en este parámetro pueden contener opcionalmente los siguientes metadatos de elemento:The files listed in this parameter may optionally contain the following item metadata:

- Primary: valor Boolean .- Primary: Boolean value. Si es true, el elemento de archivo se pasó a la matriz con el parámetro Assemblies opcional.If true, then the file item was passed into the array by using the Assemblies parameter. El valor predeterminado es false.Default value is false.
- CopyLocal: valor Boolean .- CopyLocal: Boolean value. Indica si la referencia proporcionada se debe copiar en el directorio de salida.Indicates whether the given reference should be copied to the output directory.
ResolvedDependencyFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene las rutas de acceso de enésimo ** orden a las dependencias.Contains the nth order paths to dependencies. Este parámetro no incluye las referencias principales de primer orden, que se encuentran en el parámetro ResolvedFiles .This parameter does not include first order primary references, which are contained in the ResolvedFiles parameter.

Los elementos de este parámetro opcionalmente contienen los siguientes metadatos de elementos:The items in this parameter optionally contain the following item metadata:

- CopyLocal: valor Boolean .- CopyLocal: Boolean value. Indica si la referencia proporcionada se debe copiar en el directorio de salida.Indicates whether the given reference should be copied to the output directory.
- FusionName: valor String .- FusionName: String value. Especifica el nombre de esta dependencia.Specifies the name for this dependency.
- ResolvedFrom: valor String .- ResolvedFrom: String value. Especifica la ruta de acceso de búsqueda literal desde la que se ha resuelto este archivo.Specifies the literal search path that this file was resolved from.
ResolvedFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene una lista de todas las referencias principales que se resuelven en rutas de acceso completas.Contains a list of all primary references resolved to full paths.

Los elementos de este parámetro opcionalmente contienen los siguientes metadatos de elementos:The items in this parameter optionally contain the following item metadata:

- CopyLocal: valor Boolean .- CopyLocal: Boolean value. Indica si la referencia proporcionada se debe copiar en el directorio de salida.Indicates whether the given reference should be copied to the output directory.
- FusionName: valor String .- FusionName: String value. Especifica el nombre de esta dependencia.Specifies the name for this dependency.
- ResolvedFrom: valor String .- ResolvedFrom: String value. Especifica la ruta de acceso de búsqueda literal desde la que se ha resuelto este archivo.Specifies the literal search path that this file was resolved from.
SatelliteFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Especifica los archivos satélite encontrados.Specifies any satellite files found. Serán CopyLocal=true si la referencia o dependencia que originó este elemento es CopyLocal=true.These will be CopyLocal=true if the reference or dependency that caused this item to exist is CopyLocal=true.

Los elementos de este parámetro opcionalmente contienen los siguientes metadatos de elementos:The items in this parameter optionally contain the following item metadata:

- CopyLocal: valor Boolean .- CopyLocal: Boolean value. Indica si la referencia proporcionada se debe copiar en el directorio de salida.Indicates whether the given reference should be copied to the output directory. Este valor es true si la referencia o dependencia que originó este elemento tiene un valor CopyLocal de true.This value is true if the reference or dependency that caused this item to exist has a CopyLocal value of true.
- DestinationSubDirectory: valor String .- DestinationSubDirectory: String value. Especifica el directorio de destino relativo en el que se copiará este elemento.Specifies the relative destination directory to copy this item to.
ScatterFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene los archivos de dispersión asociados a uno de los ensamblados dados.Contains the scatter files associated with one of the given assemblies.

Los elementos de este parámetro opcionalmente contienen los siguientes metadatos de elementos:The items in this parameter optionally contain the following item metadata:

- CopyLocal: valor Boolean .- CopyLocal: Boolean value. Indica si la referencia proporcionada se debe copiar en el directorio de salida.Indicates whether the given reference should be copied to the output directory.
SearchPaths Parámetro String[] requerido.Required String[] parameter.

Especifica los directorios o las ubicaciones especiales donde buscarán los archivos en disco que representan los ensamblados.Specifies the directories or special locations that are searched to find the files on disk that represent the assemblies. Es importante el orden en que se muestran las rutas de búsqueda.The order in which the search paths are listed is important. Para cada ensamblado, se busca la lista de rutas de izquierda a derecha.For each assembly, the list of paths is searched from left to right. Cuando se encuentra un archivo que representa el ensamblado, esa búsqueda se detiene y se inicia la búsqueda del siguiente ensamblado.When a file that represents the assembly is found, that search stops and the search for the next assembly starts.

Este parámetro acepta una lista separada por caracteres de punto y coma de valores que pueden ser rutas de directorio o valores literales especiales de la lista siguiente:This parameter accepts a semicolon-delimited list of values that can be either directory paths or special literal values from the list below:

- {HintPathFromItem}: especifica que la tarea examinará los metadatos HintPath del elemento base.- {HintPathFromItem}: Specifies that the task will examine the HintPath metadata of the base item.
- {CandidateAssemblyFiles}: especifica que la tarea examinará los archivos que se pasan a través del parámetro CandidateAssemblyFiles.- {CandidateAssemblyFiles}: Specifies that the task will examine the files passed in through the CandidateAssemblyFiles parameter.
- {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: especifica que la tarea buscará en carpetas adicionales especificadas en el registro.- {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: Specifies that the task will search in additional folders specified in the registry. _AssemblyFoldersBase_, _RuntimeVersion_ y _AssemblyFoldersSuffix_ deben reemplazarse por valores específicos para la ubicación del registro en la que se va a buscar._AssemblyFoldersBase_, _RuntimeVersion_, and _AssemblyFoldersSuffix_ should be replaced with specific values for the registry location to be searched. La especificación predeterminada en los destinos comunes es {Registry:$(FrameworkRegistryBase),$(TargetFrameworkVersion),$(AssemblyFoldersSuffix)$(AssemblyFoldersExConditions)}.The default specification in the common targets is {Registry:$(FrameworkRegistryBase),$(TargetFrameworkVersion),$(AssemblyFoldersSuffix)$(AssemblyFoldersExConditions)}.
- {AssemblyFolders}: especifica que la tarea usará el esquema finding-assemblies-from-registry de Visual Studio.NET 2003.- {AssemblyFolders}: Specifies the task will use the Visual Studio.NET 2003 finding-assemblies-from-registry scheme.
- {GAC}: especifica que la tarea buscará en la caché global de ensamblados (GAC).- {GAC}: Specifies the task will search in the Global Assembly Cache (GAC).
- {RawFileName}: especifica que la tarea considerará que el valor Include del elemento es un nombre de archivo y ruta exactos.- {RawFileName}: Specifies the task will consider the Include value of the item to be an exact path and file name.
SerializationAssemblyFiles Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene los ensamblados de serialización XML encontrados.Contains any XML serialization assemblies found. Estos elementos se marcan como CopyLocal=true únicamente si la referencia o dependencia que originó este elemento es CopyLocal=true.These items are marked CopyLocal=true if and only if the reference or dependency that caused this item to exist is CopyLocal=true.

CopyLocal de los metadatos Boolean indican si la referencia proporcionada se debe copiar en el directorio de salida.The Boolean metadata CopyLocal indicates whether the given reference should be copied to the output directory.
Silent Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, no se registra ningún mensaje.If true, no messages are logged. El valor predeterminado es false.The default value is false.
StateFile Parámetro String opcional.Optional String parameter.

Especifica un nombre de archivo que indica dónde debe guardarse el estado de compilación intermedio de esta tarea.Specifies a file name that indicates where to save the intermediate build state for this task.
SuggestedRedirects Parámetro de salida de solo lectura ITaskItem[] opcional.Optional ITaskItem[] read-only output parameter.

Contiene un elemento para cada una de las distintas identidades de ensamblado en conflicto, independientemente del valor del parámetro AutoUnify .Contains one item for every distinct conflicting assembly identity, regardless of the value of the AutoUnify parameter. Esto incluye todas las referencias culturales y PKT encontrados que no dispongan de una entrada bindingRedirect apropiada en el archivo de configuración de la aplicación.This includes every culture and PKT that was found that did not have a suitable bindingRedirect entry in the application configuration file.

Cada elemento contiene opcionalmente la siguiente información:Each item optionally contains the following information:

- Include : contiene el nombre completo de la familia de ensamblados con un valor de 0.0.0.0 para el campo de versión- Include attribute: Contains the full name of the assembly family with a Version field value of 0.0.0.0
- MaxVersion : contiene el número de versión máximo.- MaxVersion item metadata: Contains the maximum version number.
TargetedRuntimeVersion Parámetro String opcional.Optional String parameter.

Especifica la versión de tiempo de ejecución para el destino, por ejemplo, 2.0.57027 o v2.0.57027.Specifies the runtime version to target, for example, 2.0.57027 or v2.0.57027.
TargetFrameworkDirectories Parámetro String[] opcional.Optional String[] parameter.

Especifica la ruta de acceso del directorio del marco de trabajo de destino.Specifies the path of the target framework directory. Este parámetro es necesario para determinar el estado de CopyLocal de los elementos resultantes.This parameter is required to determine the CopyLocal status for resulting items.

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 de origen.If this parameter is not specified, no resulting items will be have a CopyLocal value of true unless they explicitly have a Private metadata value of true on their source item.
TargetFrameworkMoniker Parámetro String opcional.Optional String parameter.

TargetFrameworkMoniker que se va a supervisar, si existe.The TargetFrameworkMoniker to monitor, if any. Se usa para el registro.This is used for logging.
TargetFrameworkMonikerDisplayName Parámetro String opcional.Optional String parameter.

Nombre para mostrar de TargetFrameworkMoniker que se va a supervisar, si existe.The display name of the TargetFrameworkMoniker to monitor, if any. Se usa para el registro.This is used for logging.
TargetFrameworkSubsets Parámetro String[] opcional.Optional String[] parameter.

Contiene una lista de los nombres del subconjunto del marco de trabajo de destino que se buscarán en los directorios de marco de trabajo de destino.Contains a list of target framework subset names to be searched for in the target framework directories.
TargetFrameworkVersion Parámetro String opcional.Optional String parameter.

Versión del marco de trabajo de destino del proyecto.The project target framework version. El valor predeterminado está vacío, lo que significa que no hay ningún filtrado para las referencias basadas en el marco de trabajo de destino.The default value is empty, which means there is no filtering for the references based on target framework.
TargetProcessorArchitecture Parámetro String opcional.Optional String parameter.

Arquitectura del procesador de destino preferida.The preferred target processor architecture. Se usa para resolver referencias de la caché global de ensamblados (GAC).Used for resolving Global Assembly Cache (GAC) references.

Este parámetro puede tener un valor de x86, IA64 o AMD64.This parameter can have a value of x86, IA64 or AMD64.

Si falta este parámetro, la tarea tiene en cuenta primero los ensamblados que coinciden con la arquitectura del proceso que se está ejecutando actualmente.If this parameter is absent, the task first considers assemblies that match the architecture of the currently running process. Si no se encuentra ningún ensamblado, la tarea considera los ensamblados de la GAC que tienen el valor ProcessorArchitecture de MSIL o ningún valor ProcessorArchitecture .If no assembly is found, the task considers assemblies in the GAC that have ProcessorArchitecture value of MSIL or no ProcessorArchitecture value.

AdvertenciasWarnings

Se registran las siguientes advertencias:The following warnings are logged:

  • ResolveAssemblyReference.TurnOnAutoGenerateBindingRedirects

  • ResolveAssemblyReference.SuggestedRedirects

  • ResolveAssemblyReference.FoundConflicts

  • ResolveAssemblyReference.AssemblyFoldersExSearchLocations

  • ResolveAssemblyReference.UnifiedPrimaryReference

  • ResolveAssemblyReference.PrimaryReference

  • ResolveAssemblyReference.UnifiedDependency

  • ResolveAssemblyReference.UnificationByAutoUnify

  • ResolveAssemblyReference.UnificationByAppConfig

  • ResolveAssemblyReference.UnificationByFrameworkRetarget

ComentariosRemarks

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension Base Class.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

Vea tambiénSee Also

Tareas Tasks
Referencia de tareasTask Reference