Tarefa ResolveAssemblyReferenceResolveAssemblyReference task

Determina todos os assemblies que dependem dos assemblies especificados, incluindo o segundo e nenésimas dependências.Determines all assemblies that depend on the specified assemblies, including second and nth-order dependencies.

ParâmetrosParameters

A tabela a seguir descreve os parâmetros da tarefa ResolveAssemblyReference.The following table describes the parameters of the ResolveAssemblyReference task.

ParâmetroParameter DescriçãoDescription
AllowedAssemblyExtensions Parâmetro String[] opcional.Optional String[] parameter.

As extensões de nome de arquivo do assembly que serão usadas ao resolver referências.The assembly file name extensions to use when resolving references. As extensões de nome de arquivo padrão são .exe e .dll.The default file name extensions are .exe and .dll.
AllowedRelatedFileExtensions Parâmetro String[] opcional.Optional String[] parameter.

As extensões de nome de arquivo que serão usadas para uma pesquisa de arquivos que estão relacionados uns aos outros.The file name extensions to use for a search for files that are related to one another. As extensões padrão são .pdb e .xml.The default extensions are .pdb and .xml.
AppConfigFile Parâmetro String opcional.Optional String parameter.

Especifica um arquivo app.config do qual serão analisados e extraídos os mapeamentos bindingRedirect.Specifies an app.config file from which to parse and extract bindingRedirect mappings. Se esse parâmetro for especificado, o parâmetro AutoUnify deverá ser false.If this parameter is specified, the AutoUnify parameter must be false.
AutoUnify Parâmetro Boolean opcional.Optional Boolean parameter.

Esse parâmetro é usado para criar assemblies, como DLLs, que não podem ter um arquivo App.Config normal.This parameter is used for building assemblies, such as DLLs, which cannot have a normal App.Config file.

Se true, o grafo de dependência resultante será tratado automaticamente como se um arquivo App.Config tivesse passado para o parâmetro AppConfigFile.When true, the resulting dependency graph is automatically treated as if there were an App.Config file passed in to the AppConfigFile parameter. Esse arquivo App.Config virtual tem uma entrada de bindingRedirect para cada conjunto conflitante de assemblies, de modo que o assembly de versão mais alto é escolhido.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies such that the highest version assembly is chosen. Uma consequência disso é que nunca haverá um aviso sobre assemblies conflitantes porque cada conflito terá sido resolvido.A consequence of this is that there will never be a warning about conflicting assemblies, because every conflict will have been resolved.

Quando true, cada remapeamento distinto resultará em um comentário de alta prioridade, mostrando as versões nova e antiga e que AutoUnify foi true.When true, each distinct remapping will result in a high priority comment showing the old and new versions and that AutoUnify was true.

Quando for true, o parâmetro AppConfigFile deverá estar vazio.When true, the AppConfigFile parameter must be empty.

Quando false, nenhum remapeamento da versão do assembly ocorrerá automaticamente.When false, no assembly version remapping will occur automatically. Quando existir duas versões de um assembly, um aviso será emitido.When two versions of an assembly are present, a warning is issued.

Quando false, cada conflito distinto entre versões diferentes do mesmo assembly resultará em um comentário de alta prioridade.When false, each distinct conflict between different versions of the same assembly results in a high-priority comment. Esses comentários são seguidos por um único aviso.These comments are followed by a single warning. O aviso tem um código de erro exclusivo e contém o texto "Encontrados conflitos entre diferentes versões de referência e assemblies dependentes".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 opcional ITaskItem[].Optional ITaskItem[] parameter.

Especifica os itens para os quais as dependências e caminhos completos devem ser identificados.Specifies the items for which full paths and dependencies must be identified. Esses itens podem ter nomes simples como "Sistema" ou nomes fortes, 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".

Itens passados para esse parâmetro podem, opcionalmente, ter os metadados de item a seguir:Items passed to this parameter may optionally have the following item metadata:

Valor - Private: Boolean.- Private: Boolean value. Se true, então o item será copiado localmente.If true, then the item is copied locally. O valor padrão é true.The default value is true.
Valor - HintPath: String.- HintPath: String value. Especifica o caminho e nome de arquivo que será usado como referência.Specifies the path and file name to use as a reference. Esses metadados são usados quando {HintPathFromItem} é especificado no parâmetro SearchPaths.This metadata is used when {HintPathFromItem} is specified in the SearchPaths parameter. O valor padrão é uma cadeia de caracteres vazia.The default value is an empty string.
Valor - SpecificVersion: Boolean.- SpecificVersion: Boolean value. Se true, então o nome exato especificado no atributo Include deverá corresponder.If true, then the exact name specified in the Include attribute must match. Se false, qualquer assembly com o mesmo nome simples funcionará.If false, then any assembly with the same simple name will work. Se SpecificVersion não for especificado, então a tarefa examinará o valor do atributo Include do item.If SpecificVersion is not specified, then the task examines the value in the Include attribute of the item. Se o atributo for um nome simples, ele se comportará como se SpecificVersion tivesse sido false.If the attribute is a simple name, it behaves as if SpecificVersion was false. Se o atributo for um nome forte, ele se comportará como se SpecificVersion tivesse sido true.If the attribute is a strong name, it behaves as if SpecificVersion was true.
Quando usado com um tipo de item de referência, o atributo Include deve ser o nome completo de fusão do assembly a ser resolvido.When used with a Reference item type, the Include attribute needs to be the full fusion name of the assembly to be resolved. O assembly será resolvido apenas se a fusão corresponder exatamente ao atributo Include.The assembly is only resolved if fusion exactly matches the Include attribute.
Quando um projeto tem como alvo uma versão do .NET Framework e referencia um assembly compilado para uma versão posterior do .NET Framework, a referência será resolvida apenas se ela tiver SpecificVersion definido como 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.
Quando um projeto tem como alvo um perfil e faz referencia um assembly que não está no perfil, a referência será resolvida apenas se ela tiver SpecificVersion definido como 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.
Valor - ExecutableExtension: String.- ExecutableExtension: String value. Quando presente, o assembly resolvido deve ter essa extensão.When present, the resolved assembly must have this extension. Quando ausente, o .dll é considerado primeiro, seguido por .exe, para cada diretório examinado.When absent, .dll is considered first, followed by .exe, for each examined directory.
Valor - SubType: String.- SubType: String value. Somente os itens com metadados SubType vazios serão resolvidos em caminhos de assembly completo.Only items with empty SubType metadata will be resolved into full assembly paths. Itens com metadados SubType não vazios são ignorados.Items with non-empty SubType metadata are ignored.
Valor - AssemblyFolderKey: String.- AssemblyFolderKey: String value. Esses metadados têm suporte para fins de herdado.This metadata is supported for legacy purposes. Ele especifica uma chave do Registro definida pelo usuário, como hklm\<VendorFolder>", que Assemblies deve usar para resolver referências de assembly.It specifies a user-defined registry key, such as hklm\<VendorFolder>, that Assemblies should use to resolve assembly references.
AssemblyFiles Parâmetro opcional ITaskItem[].Optional ITaskItem[] parameter.

Especifica uma lista de assemblies totalmente qualificados para encontrar as dependências.Specifies a list of fully qualified assemblies for which to find dependencies.

Itens passados para esse parâmetro podem, opcionalmente, ter os metadados de item a seguir:Items passed to this parameter may optionally have the following item metadata:

- Private: um valor Boolean opcional.- Private: an optional Boolean value. Se for verdadeiro, então o item será copiado localmente.If true, the item is copied locally.
- FusionName: metadados String opcionais.- FusionName: optional String metadata. Especifica o nome simples ou forte para esse item.Specifies the simple or strong name for this item. Se esse atributo estiver presente, isso poderá economizar tempo porque o arquivo do assembly não precisa ser aberto para obter o nome.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.

Se true, o grafo de dependência resultante será tratado automaticamente como se um arquivo App.Config tivesse passado para o 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. Esse arquivo App.Config virtual tem uma entrada de bindingRedirect para cada conjunto conflitante de assemblies, de modo que o assembly de versão mais recente é escolhido.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies so that the highest version assembly is chosen. Um resultado disso é que nunca haverá um aviso sobre assemblies conflitantes porque cada conflito terá sido resolvido.A result of this is that there will never be a warning about conflicting assemblies because every conflict will have been resolved. Cada remapeamento distintos causará um comentário de alta prioridade que indica as versões antigas e novas e o fato de que isso foi feito automaticamente porque AutoUnify foi 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.

Se false, nenhum remapeamento da versão do assembly ocorrerá automaticamente.If false, no assembly version remapping will occur automatically. Quando existir duas versões de um assembly, um aviso será emitido.When two versions of an assembly are present, there will be a warning. Cada conflito distinto entre versões diferentes do mesmo assembly resultará em um comentário de alta prioridade.Each distinct conflict between different versions of the same assembly will cause a high priority comment. Depois que todos esses comentários forem exibidos, haverá um único aviso com um único código de erro e texto informando que foram "encontrados conflitos entre diferentes versões de referência e assemblies dependentes".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".

O valor padrão é false.The default value is false.
CandidateAssemblyFiles Parâmetro String[] opcional.Optional String[] parameter.

Especifica uma lista de assemblies que serão usados para o processo de pesquisa e resolução.Specifies a list of assemblies to use for the search and resolution process. Os valores passados para este parâmetro devem ser nomes de arquivos absolutos ou nomes de arquivos relacionados ao projeto.Values passed to this parameter must be absolute file names or project-relative file names.

Os assemblies nesta lista serão considerados quando o parâmetro SearchPaths contiver {CandidateAssemblyFiles} como um dos caminhos a serem considerados.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.

Se for verdadeiro, para determinar se uma dependência deverá ser copiada localmente, uma das verificações feitas é ver se a referência pai no arquivo de projeto tem metadados particulares definidos.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. Se definido, o valor particular será usado como uma dependência.If set, then the Private value is used as a dependency.

Se os metadados não estiverem definidos, então a dependência passará pelas mesmas verificações da referência pai.If the metadata is not set, then the dependency goes through the same checks as the parent reference. Uma dessas verificações é ver se a referência está no GAC.One of these checks is to see if the reference is in the GAC. Se uma referência estiver no GAC, então ela não será copiada localmente, porque ela é considerada como estando no GAC no computador 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. Isso é aplicável somente a uma referência específica e não a suas dependências.This only applies to a specific reference and not its dependencies.

Por exemplo, uma referência no arquivo de projeto que está no GAC não é copiada localmente, mas suas dependências são copiadas localmente porque elas não estão no 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.

Se falso, as referências de arquivo de projeto são verificadas para ver se elas estão no GAC e são copiadas localmente, conforme apropriado.If false, project file references are checked to see if they are in the GAC, and are copied locally as appropriate.

As dependências são verificadas para ver se elas estão no GAC e também são verificadas para ver se a referência pai do arquivo de projeto está no 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.

Se a referência pai do arquivo de projeto estiver no GAC, a dependência não será copiada localmente.If the parent reference from the project file is in the GAC, the dependency is not copied locally.

Independentemente de esse parâmetro ser verdadeiro ou falso, se houver várias referências pai e uma delas não estiver no GAC, todas elas serão copiadas 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 ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Retorna todos os arquivos nos parâmetros ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles e ScatterFiles e que têm os metadados de item CopyLocal com um 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 saída ITaskItem[] opcional.Optional ITaskItem[] output parameter.

Contém os itens gravados em disco.Contains the items written to disk.
FindDependencies Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, as dependências serão encontradas.If true, dependencies will be found. Caso contrário, apenas as referências principais serão encontradas.Otherwise, only primary references are found. O valor padrão é true.The default value is true.
FindRelatedFiles Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, arquivos relacionados, como arquivos .pdb e arquivos .xml serão encontrados.If true, related files such as .pdb files and xml files will be found. O valor padrão é true.The default value is true.
FindSatellites Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, os assemblies satélites serão encontrados.If true, satellite assemblies will be found. O valor padrão é true.The default value is true.
FindSerializationAssemblies Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, a tarefa pesquisará os assemblies de serialização.If true, then the task searches for serialization assemblies. O valor padrão é true.The default value is true.
FullFrameworkAssemblyTables Parâmetro opcional ITaskItem[].Optional ITaskItem[] parameter.

Especifica os itens que têm metadados "FrameworkDirectory" para associar uma lista redist a um diretório de estrutura específica.Specifies items that have "FrameworkDirectory" metadata to associate a redist list with a particular framework directory. Se a associação não for feita, um erro será registrado.If the association is not made, an error will be logged. A lógica de RAR (referência do assembly de resolução) usará o diretório da estrutura de destino se um FrameworkDirectory não estiver definido.The resolve assembly reference (RAR) logic uses the target framework directory if a FrameworkDirectory is not set.
FullFrameworkFolders Parâmetro opcional System.String[].Optional System.String[] parameter.

Especifica as pastas que contêm um diretório RedistList.Specifies the folders that contain a RedistList directory. Esse diretório representa a estrutura completa para um perfil de cliente, por exemplo, %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.

Contém uma lista de nomes de subconjunto de estrutura de destino.Contains a list of target framework subset names. Se um nome de subconjunto na lista corresponde a um na propriedade de nome TargetFrameworkSubset, o sistema exclui esse subconjunto de estrutura de destino específico no momento do build.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.

Se true, então a tarefa pesquisa e usa as tabelas de assembly instaladas adicionais (ou "Lista Redist") que estão localizadas no diretório \RedistList em 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. O valor padrão é false.The default value is false.
IgnoreDefaultInstalledAssemblySubsetTables Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, então a tarefa pesquisa e usa as tabelas de subconjunto de assembly instaladas adicionais (ou "Listas de Subconjunto") que estão localizadas no diretório \SubsetList em 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. O valor padrão é false.The default value is false.
InstalledAssemblySubsetTables Parâmetro opcional ITaskItem[].Optional ITaskItem[] parameter.

Contém uma lista de arquivos XML que especificam os assemblies que devem estar no subconjunto do destino.Contains a list of XML files that specify the assemblies that are expected to be in the target subset.

Como opção, os itens nessa lista podem especificar os metadados de "FrameworkDirectory" para associar a um InstalledAssemblySubsetTableAs an option, items in this list can specify the "FrameworkDirectory" metadata to associate an InstalledAssemblySubsetTable

com um diretório de estrutura específico.with a particular framework directory.

Se houver apenas um elemento TargetFrameworkDirectories, então todos os itens na lista que não têm os metadados de "FrameworkDirectory" são tratados como se eles fossem definidos como o valor exclusivo que é passado para 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.

Contém uma lista de arquivos XML que especificam os assemblies que devem ser instalados no computador de destino.Contains a list of XML files that specify the assemblies that are expected to be installed on the target computer.

Quando InstalledAssemblyTables estiver definido, as versões anteriores dos assemblies na lista serão mescladas em versões mais recentes listadas no 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. Além disso, os assemblies que têm uma configuração de InGAC = 'true' são considerados pré-requisitos e são definidos como CopyLocal = 'false', a menos que explicitamente substituídos.Also, assemblies that have a setting of InGAC='true' are considered prerequisites and are set to CopyLocal='false' unless explicitly overridden.

Como opção, os itens nessa lista podem especificar os metadados de "FrameworkDirectory" para associar a um InstalledAssemblyTable com um diretório de estrutura específico.As an option, items in this list can specify "FrameworkDirectory" metadata to associate an InstalledAssemblyTable with a particular framework directory. No entanto, essa configuração será ignorada a menos que o nome do Redist comece comHowever, this setting is ignored unless the Redist name begins with

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

Se houver apenas um elemento TargetFrameworkDirectories, então todos os itens na lista que não têm os metadados de "FrameworkDirectory" são tratados como se eles fossem definidos como o valor exclusivo que é passadoIf 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

para TargetFrameworkDirectories.to TargetFrameworkDirectories.
LatestTargetFrameworkDirectories Parâmetro String[] opcional.Optional String[] parameter.

Especifica uma lista de diretórios que contêm as listas redist para a estrutura mais recente que possa ser direcionada no computador.Specifies a list of directories that contain the redist lists for the most current framework that can be targeted on the machine. Se isso não for definido a estrutura mais recente instalada no computador para um identificador de estrutura de destino fornecido será usada.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 o nome do perfil da estrutura que será direcionado.- Specifies the name of the framework profile to be targeted. Por exemplo, cliente, Web ou rede.For example, Client, Web, or Network.
RelatedFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém os arquivos relacionados, como arquivos XML e .pdb que têm o mesmo nome de base como referência.Contains related files, such as XML and .pdb files that have the same base name as a reference.

Os arquivos listados nesse parâmetro podem, opcionalmente, ter os metadados de item a seguir:The files listed in this parameter may optionally contain the following item metadata:

Valor - Primary: Boolean.- Primary: Boolean value. Se true, então o item do arquivo foi passado para a matriz usando o parâmetro Assemblies.If true, then the file item was passed into the array by using the Assemblies parameter. O valor padrão é false.Default value is false.
Valor - CopyLocal: Boolean.- CopyLocal: Boolean value. Indica se a referência será copiada no diretório de saída.Indicates whether the given reference should be copied to the output directory.
ResolvedDependencyFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém os caminhos de ordem n para as dependências.Contains the nth order paths to dependencies. Esse parâmetro não inclui referências de primeira ordem, que estão contidas no parâmetro ResolvedFiles.This parameter does not include first order primary references, which are contained in the ResolvedFiles parameter.

Os itens nesse parâmetro podem, opcionalmente, ter os metadados de item a seguir:The items in this parameter optionally contain the following item metadata:

Valor - CopyLocal: Boolean.- CopyLocal: Boolean value. Indica se a referência será copiada no diretório de saída.Indicates whether the given reference should be copied to the output directory.
Valor - FusionName: String.- FusionName: String value. Especifica o nome para essa dependência.Specifies the name for this dependency.
Valor - ResolvedFrom: String.- ResolvedFrom: String value. Especifica o caminho de pesquisa literal do qual este arquivo foi resolvido.Specifies the literal search path that this file was resolved from.
ResolvedFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém uma lista de todas as referências primárias resolvidas para caminhos completos.Contains a list of all primary references resolved to full paths.

Os itens nesse parâmetro podem, opcionalmente, ter os metadados de item a seguir:The items in this parameter optionally contain the following item metadata:

Valor - CopyLocal: Boolean.- CopyLocal: Boolean value. Indica se a referência será copiada no diretório de saída.Indicates whether the given reference should be copied to the output directory.
Valor - FusionName: String.- FusionName: String value. Especifica o nome para essa dependência.Specifies the name for this dependency.
Valor - ResolvedFrom: String.- ResolvedFrom: String value. Especifica o caminho de pesquisa literal do qual este arquivo foi resolvido.Specifies the literal search path that this file was resolved from.
SatelliteFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Especifica todos os arquivos satélites encontrados.Specifies any satellite files found. Eles serão CopyLocal=true se a referência ou a dependência que causou a existência deste item for CopyLocal=true.These will be CopyLocal=true if the reference or dependency that caused this item to exist is CopyLocal=true.

Os itens nesse parâmetro podem, opcionalmente, ter os metadados de item a seguir:The items in this parameter optionally contain the following item metadata:

Valor - CopyLocal: Boolean.- CopyLocal: Boolean value. Indica se a referência será copiada no diretório de saída.Indicates whether the given reference should be copied to the output directory. Esse valor é true se a referência ou a dependência que causou a existência deste item tiver um 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.
Valor - DestinationSubDirectory: String.- DestinationSubDirectory: String value. Especifica o diretório de destino relativo ao qual copiar este item.Specifies the relative destination directory to copy this item to.
ScatterFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém os arquivos de dispersão associados a um dos assemblies.Contains the scatter files associated with one of the given assemblies.

Os itens nesse parâmetro podem, opcionalmente, ter os metadados de item a seguir:The items in this parameter optionally contain the following item metadata:

Valor - CopyLocal: Boolean.- CopyLocal: Boolean value. Indica se a referência será copiada no diretório de saída.Indicates whether the given reference should be copied to the output directory.
SearchPaths Parâmetro String[] obrigatório.Required String[] parameter.

Especifica os diretórios ou locais especiais que são pesquisados para localizar os arquivos no disco que representam os assemblies.Specifies the directories or special locations that are searched to find the files on disk that represent the assemblies. A ordem na qual os caminhos de pesquisa são listados é importante.The order in which the search paths are listed is important. Para cada assembly, a lista de caminhos é pesquisada da esquerda para a direita.For each assembly, the list of paths is searched from left to right. Quando um arquivo que representa o assembly for encontrado, a pesquisa será interrompida e a pesquisa do próximo assembly começará.When a file that represents the assembly is found, that search stops and the search for the next assembly starts.

Esse parâmetro aceita uma lista delimitada por ponto-e-vírgula dos valores que podem ser caminhos de diretório ou valores literais especiais da lista abaixo: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 a tarefa examinará os metadados HintPath do item de base.- {HintPathFromItem}: Specifies that the task will examine the HintPath metadata of the base item.
- {CandidateAssemblyFiles}: especifica que a tarefa examinará os arquivos transmitidos por meio do parâmetro CandidateAssemblyFiles.- {CandidateAssemblyFiles}: Specifies that the task will examine the files passed in through the CandidateAssemblyFiles parameter.
- {Registry: <AssemblyFoldersBase>, <RuntimeVersion>, <AssemblyFoldersSuffix>}: especifica que a tarefa pesquisará em pastas adicionais especificadas no Registro.- {Registry: <AssemblyFoldersBase>, <RuntimeVersion>, <AssemblyFoldersSuffix>}: Specifies that the task will search in additional folders specified in the registry. <AssemblyFoldersBase>, <RuntimeVersion> e <AssemblyFoldersSuffix> devem ser substituídos por valores específicos para o local do Registro a ser pesquisado.<AssemblyFoldersBase>, <RuntimeVersion>, and <AssemblyFoldersSuffix> should be replaced with specific values for the registry location to be searched. A especificação padrão nos destinos comuns é {Registry:$(FrameworkRegistryBase), $(TargetFrameworkVersion), $(AssemblyFoldersSuffix), $(AssemblyFoldersExConditions)}.The default specification in the common targets is {Registry:$(FrameworkRegistryBase), $(TargetFrameworkVersion), $(AssemblyFoldersSuffix), $(AssemblyFoldersExConditions)}.
- {AssemblyFolders}: especifica que a tarefa usará o esquema de localizar assemblies de Registro do Visual Studio.NET 2003.- {AssemblyFolders}: Specifies the task will use the Visual Studio.NET 2003 finding-assemblies-from-registry scheme.
- {GAC}: especifica a tarefa que pesquisará no GAC (Cache de Assembly Global).- {GAC}: Specifies the task will search in the Global Assembly Cache (GAC).
- {RawFileName}: especifica que a tarefa considerará o valor Include do item como um nome de arquivo e caminho exato.- {RawFileName}: Specifies the task will consider the Include value of the item to be an exact path and file name.
SerializationAssemblyFiles Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém os assemblies de serialização XML encontrados.Contains any XML serialization assemblies found. Esses itens serão marcados como CopyLocal=true se a referência ou a dependência que causou a existência deste item for 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.

O CopyLocal dos metadados Boolean indica se a referência fornecida deve ser copiada para o diretório de saída.The Boolean metadata CopyLocal indicates whether the given reference should be copied to the output directory.
Silent Parâmetro Boolean opcional.Optional Boolean parameter.

Se true, nenhuma mensagem será registrada.If true, no messages are logged. O valor padrão é false.The default value is false.
StateFile Parâmetro String opcional.Optional String parameter.

Especifica um nome de arquivo que indica onde salvar o estado de build intermediária para essa tarefa.Specifies a file name that indicates where to save the intermediate build state for this task.
SuggestedRedirects Parâmetro ITaskItem[] de saída opcional somente leitura.Optional ITaskItem[] read-only output parameter.

Contém um item para cada identidade de assembly distinto em conflito, independentemente do valor do parâmetro AutoUnify.Contains one item for every distinct conflicting assembly identity, regardless of the value of the AutoUnify parameter. Isso inclui cada cultura e PKT encontrados que não tinham uma entrada bindingRedirect adequada no arquivo de configuração de aplicativo.This includes every culture and PKT that was found that did not have a suitable bindingRedirect entry in the application configuration file.

Cada item contém, opcionalmente, as informações a seguir:Each item optionally contains the following information:

Atributo - Include: contém o nome completo da família do assembly com um valor de campo de versão de 0.0.0.0- Include attribute: Contains the full name of the assembly family with a Version field value of 0.0.0.0
Metadados de item - MaxVersion: contém o número máximo de versão.- MaxVersion item metadata: Contains the maximum version number.
TargetedRuntimeVersion Parâmetro String opcional.Optional String parameter.

Especifica a versão de tempo de execução para o destino, por exemplo, 2.0.57027 ou 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 o caminho do diretório da estrutura de destino.Specifies the path of the target framework directory. Este parâmetro é necessário para determinar o status de CopyLocal para os itens resultantes.This parameter is required to determine the CopyLocal status for resulting items.

Se esse parâmetro não for especificado, nenhum item resultante terá um valor CopyLocal de true, a menos que tenham explicitamente um valor de metadados Private de true em seu item de origem.If this parameter is not specified, no resulting items will 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.

O TargetFrameworkMoniker para monitorar, se houver.The TargetFrameworkMoniker to monitor, if any. Isso é usado para registro em log.This is used for logging.
TargetFrameworkMonikerDisplayName Parâmetro String opcional.Optional String parameter.

O nome de exibição do TargetFrameworkMoniker para monitorar, se houver.The display name of the TargetFrameworkMoniker to monitor, if any. Isso é usado para registro em log.This is used for logging.
TargetFrameworkSubsets Parâmetro String[] opcional.Optional String[] parameter.

Contém uma lista de nomes de subconjunto da estrutura de destino que será pesquisada em diretórios da estrutura 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.

A versão da estrutura de destino do projeto.The project target framework version. O valor padrão é vazio, o que significa que não há nenhuma filtragem para as referências com base na estrutura 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.

A arquitetura do processador de destino preferencial.The preferred target processor architecture. Usada para resolver referências de GAC (Cache de Assembly Global).Used for resolving Global Assembly Cache (GAC) references.

Esse parâmetro pode ter um valor igual a x86, IA64 ou AMD64.This parameter can have a value of x86, IA64, or AMD64.

Se esse parâmetro estiver ausente, a tarefa considerará primeiro assemblies que correspondem à arquitetura do processo em execução no momento.If this parameter is absent, the task first considers assemblies that match the architecture of the currently running process. Se nenhum assembly for encontrado, a tarefa considerará os assemblies no GAC com valor ProcessorArchitecture de MSIL ou nenhum valor ProcessorArchitecture.If no assembly is found, the task considers assemblies in the GAC that have ProcessorArchitecture value of MSIL or no ProcessorArchitecture value.

AvisosWarnings

Os seguintes avisos são registrados: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

ComentáriosRemarks

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.For a list of these additional parameters and their descriptions, see TaskExtension base class.

Consulte tambémSee also

Tarefas Tasks
Referência de tarefasTask reference