Tarefa de ResolveAssemblyReference

Determina a todos os assemblies que dependem as montagens especificadas. Isso inclui o segundo e nth ordem dependências.

Parâmetros

A tabela a seguir descreve os parâmetros da ResolveAssemblyReference de tarefas.

Parâmetro	Descrição
AllowedAssemblyExtensions	Opcional String[] parâmetro. As extensões de nome de arquivo do assembly para usar ao resolver referências. As extensões de nome de arquivo padrão são. exe e. dll.
AllowedRelatedFileExtensions	Opcional String[] parâmetro. As extensões de nome de arquivo a ser usado para uma pesquisa de arquivos que estão relacionados entre si. As extensões padrão são. PDB e. XML.
AppConfigFile	Opcional String parâmetro. Especifica um arquivo app. config analisar e extrair bindingRedirect mapeamentos. Se este parâmetro for especificado, o AutoUnify parâmetro deve ser false.
AutoUnify	Opcional Boolean parâmetro. Este parâmetro é usado para criar assemblies, como, por exemplo, DLLs, que não podem ter um arquivo app. config de normal. Quando true, o gráfico de dependência resultante automaticamente é tratado como se houvesse um arquivo de anApp.Config passado para o parâmetro AppConfigFile. Este arquivo virtual do App. config tem uma entrada bindingRedirect para cada conjunto conflitante de módulos (assemblies) que o assembly de versão mais alto é escolhido. Uma conseqüência disso é que nunca haverá um aviso sobre assemblies conflitantes porque cada conflito serão resolvidos. Quando true, cada remapeamento distintos resultará em um comentário de alta prioridade, mostrando as versões antigas e nova e que AutoUnify foi true. Quando true, o parâmetro AppConfigFile deve estar vazio Quando false, nenhuma versão de assembly remapeamento ocorrerá automaticamente. Quando duas versões de um assembly estão presentes, um aviso é emitido. Quando false, cada conflito distinto entre versões diferentes dos resultados mesmo assembly em um comentário de alta prioridade. Esses comentários são seguidos de um único aviso. O aviso tem um código de erro exclusivo e contém o texto que lê "Encontrados conflitos entre versões diferentes de referência e assemblies dependentes".
Assemblies	Opcional ITaskItem[] parâmetro. Especifica os itens para os quais as dependências e os caminhos completos devem ser identificadas. Esses itens podem ter qualquer um dos nomes simples como "Sistema" ou nomes de alta segurança como "sistema, versão = 2.0.3500.0, Culture = neutral, PublicKeyToken = b77a5c561934e089." Os itens passados para este parâmetro opcionalmente podem ter os metadados de item a seguir: Private: Booleanvalor. Se true, e em seguida, o item é copiado localmente. O valor padrão é true. HintPath: Stringvalor. Especifica o caminho e nome de arquivo para usar como referência. Isso é usado quando {HintPathFromItem} é especificado na SearchPaths parâmetro. O valor padrão é uma sequência vazia. SpecificVersion: Booleanvalor. Se true, e em seguida, o nome exato especificado a Include atributo deve coincidir. Se false, em seguida, qualquer conjunto com o mesmo nome simple será funciona. Se SpecificVersion não for especificado, então a tarefa examina o valor de Include atributo do item. Se o atributo for um nome simples, ele se comporta como se SpecificVersion foi false. Se o atributo é um nome forte, ele se comporta como se SpecificVersion foi true. Quando usado com um tipo de item de referência, o Include atributo precisa ser o nome completo de fusão do assembly deve ser resolvido. O assembly só será resolvido se fusion coincide exatamente com o Include atributo. Quando os destinos de um projeto um.NET Framework versão e referências a um assembly compilado para uma posição superior.NET Framework versão, a referência resolve apenas se ele tem SpecificVersion definido como true. Quando um projeto destina-se a um perfil e referencia um assembly que não está no perfil, a referência resolve apenas se ele tem SpecificVersion definido como true. ExecutableExtension: Stringvalor. Quando presente, o assembly resolvido deve ter esta extensão. Quando ausente,. dll é considerado primeiro, seguido por. exe, para cada diretório de inspeção. SubType: Stringvalor. Somente os itens com metadados de subtipo vazio serão resolvidos em caminhos de assembly completo. Itens com metadados de subtipo não vazia são ignorados. AssemblyFolderKey: Stringvalor. Esses metadados é suportado para fins de legado. Ele especifica uma chave de registro definido pelo usuário, como "hklm\VendorFolder", que Assemblies deve usar para resolver referências de assembly.
AssemblyFiles	Opcional ITaskItem[] parâmetro. Especifica uma lista de assemblies totalmente qualificados para o qual deseja encontrar dependências. Os itens passados para este parâmetro opcionalmente podem ter os metadados de item a seguir: Private: um recurso opcional Boolean valor. Se for true, o item é copiado localmente. FusionName: opcional String metadados. Especifica o nome simple ou de alta segurança para este item. Se esse atributo estiver presente, ele pode economizar tempo, porque o arquivo do assembly não precisa ser aberto para obter o nome.
AutoUnify	Opcional Boolean parâmetro. Se true, o gráfico de dependência resultante automaticamente é tratado como se fosse um arquivo app. config passado para o parâmetro AppConfigFile. Este arquivo virtual do App. config tem uma entrada bindingRedirect para cada conjunto conflitante de módulos (assemblies) para que o assembly de versão mais alto é escolhido. Um resultado disso é que nunca haverá um aviso sobre assemblies conflitantes porque cada conflito serão resolvidos. Cada remapeamento distintos fará com que um comentário de alta prioridade que indica as versões antigas e nova e o fato de que isso foi feito automaticamente porque AutoUnify foi true. Se false, nenhuma versão de assembly remapeamento ocorrerá automaticamente. Quando duas versões de um assembly estão presentes, haverá um aviso. Cada conflito distinto entre versões diferentes do mesmo assembly fará com que um comentário de alta prioridade. Depois de todos esses comentários são exibidos, haverá um único aviso com um único erro de código e texto que lê "encontram conflitos entre versões diferentes de referência e assemblies dependentes". O valor padrão é false.
CandidateAssemblyFiles	Opcional String[] parâmetro. Especifica uma lista de assemblies para usar para o processo de resolução e pesquisa. Valores passados para este parâmetro devem ser nomes de arquivo absoluto ou relativo ao projeto de arquivo. Assemblies nesta lista serão considerados quando o SearchPaths parâmetro contém {CandidateAssemblyFiles} como um dos caminhos a serem considerados.
CopyLocalDependenciesWhenParentReferenceInGac	Opcional [Boolean] parâmetro. Se verdadeiro determinar se uma dependência deve ser copiada localmente, uma das verificações feitas ver se a referência de pai no arquivo de projeto tem metadados particular definido. Se o conjunto, em seguida, o valor particular é usado como uma dependência. Se os metadados não estiver definido, então a dependência passa por verificações mesmas como a referência do pai. Uma dessas verificações é se a referência está no GAC. Se uma referência no GAC, em seguida, ele não é copiado localmente, porque ele é considerado no GAC na máquina de destino. Isso se aplica somente uma referência específica e não suas dependências. 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 eles não estão no GAC. Se for falso, referências de arquivo de projeto são verificadas para ver se eles estão no GAC e são copiados localmente, conforme apropriados. Dependências são verificadas para ver se eles estão no GAC e também são verificadas para ver se a referência do pai do arquivo de projeto está no GAC. Se a referência do pai do arquivo de projeto está no GAC, a dependência não é copiada localmente. Se este parâmetro for true ou false, se houver várias referências de pai e qualquer uma delas não estão no GAC, todas elas são copiadas localmente.
CopyLocalFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Retorna todos os arquivos de ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, e ScatterFiles parâmetros que tem CopyLocal os metadados de item com um valor de true.
FilesWritten	Opcional ITaskItem[] parâmetro de saída. Contém os itens gravados em disco.
FindDependencies	Opcional Boolean parâmetro. Se true, dependências serão encontradas. Caso contrário, somente as referências principais são encontradas. O valor padrão é true.
FindRelatedFiles	Opcional Boolean parâmetro. Se true, relacionados a arquivos como arquivos. PDB e arquivos. XML serão encontrados. O valor padrão é true.
FindSatellites	Opcional Boolean parâmetro. Se true, assemblies satélites serão encontrados. O valor padrão étrue.
FindSerializationAssemblies	Opcional Boolean parâmetro. Se true, em seguida, a tarefa de procura para assemblies de serialização. O valor padrão é true.
FullFrameworkAssemblyTables	Opcional ITaskItem[] parâmetro. Especifica os itens que têm "frameworkdirectory" metadados para associar a um diretório específico de estrutura de uma lista redist. Se a associação não é feita, um erro será registrado. A lógica de referência (RAR) resolver assembly usa o diretório do framework de destino se um FrameworkDirectory não está definida..
FullFrameworkFolders	Opcional [String][] parâmetro. Especifica o conjunto de pastas que contêm um diretório de RedistList. Este diretório representa a estrutura completa para um perfil de determinado cliente, por exemplo, o diretório assemblies\microsoft\framework\v4.0.
FullTargetFrameworkSubsetNames	Opcional String[] parâmetro. Contém uma lista de nomes de subconjunto de estrutura de destino. Se um nome de subconjunto da lista corresponde a um na TargetFrameworkSubset a propriedade de nome, e em seguida, o sistema exclui esse subconjunto de estrutura de destino específico no tempo de compilação.
IgnoreDefaultInstalledAssemblyTables	Opcional Boolean parâmetro. Se true, em seguida, a tarefa de pesquisa e usos adicionais instalados assembly tabelas (ou "Lista Redist") que são encontrados no diretório \RedistList em TargetFrameworkDirectories. O valor padrão éfalse.
IgnoreDefaultInstalledAssemblySubsetTables	Opcional Boolean parâmetro. Se true, em seguida, a tarefa de pesquisa e usos adicionais instalados assembly tabelas de subconjunto (ou "Listas de subconjunto") que são encontrados no diretório \SubsetList em TargetFrameworkDirectories. O valor padrão éfalse.
InstalledAssemblySubsetTables	Opcional ITaskItem[] parâmetro. Contém uma lista de arquivos XML que especificam os assemblies que são esperados no subconjunto de destino. Como opção, os itens nesta lista podem especificar "frameworkdirectory" metadados para associar umInstalledAssemblySubsetTable com um diretório específico do framework. Se houver apenas um TargetFrameworkDirectories elemento, em seguida, todos os itens nesta lista, que não têm "frameworkdirectory" metadados são tratados como elas são definidas como o valor exclusivo que é passado para TargetFrameworkDirectories.
InstalledAssemblyTables	Opcional String parâmetro. Contém uma lista de arquivos XML que especificam os assemblies que são esperados ser instalado no computador de destino. Quando InstalledAssemblyTables estiver definida, as versões anteriores dos assemblies na lista serão mescladas com as versões mais recentes que estão listadas em XML. Além disso, os assemblies que têm uma configuração de InGAC = 'true' são considerados pré-requisitos e são definidas como CopyLocal = 'false' a menos que explicitamente substituída. Como opção, os itens nesta lista podem especificar "frameworkdirectory" metadados para associar um InstalledAssemblyTable com um diretório específico framework. No entanto, essa configuração é ignorada a menos que o nome do pacote redistribuível começa com "Microsoft-Windows-clrcorecomp". Se houver apenas um TargetFrameworkDirectories elemento, em seguida, todos os itens nesta lista, que não têm "frameworkdirectory" metadados são tratados como se elas estiverem definidas para o valor exclusivo que é passado to TargetFrameworkDirectories.
LatestTargetFrameworkDirectories	Opcional String[] parâmetro. Especifica uma lista de diretórios que contêm listas redist para o framework mais atual que pode ser alvo na máquina. Se isso não é definido mais alto framework instalado na máquina de um identificador de estrutura de destino fornecido é usado.
ProfileName	Opcional [String] parâmetro. Especifica o nome do perfil do framework será alvo. Por exemplo, cliente, Web ou rede.
RelatedFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém arquivos relacionados, como arquivos XML e. PDB que têm o mesmo nome de base como uma referência. Os arquivos listados neste parâmetro opcionalmente podem conter os metadados de item a seguir: Primary: Booleanvalor. Se true, e em seguida, o item de arquivo foi passado para a matriz, usando o Assemblies parâmetro. Valor padrão é false. CopyLocal: Booleanvalor. Indica se a referência fornecida deve ser copiada para o diretório de saída.
ResolvedDependencyFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém o ncaminhos de ordem th dependências. Este parâmetro não inclui o primeira primário referências das ordens, que estão contidas no ResolvedFiles parâmetro. Opcionalmente, os itens neste parâmetro contêm os metadados de item a seguir: CopyLocal: Booleanvalor. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: Stringvalor. Especifica o nome para essa dependência. ResolvedFrom: Stringvalor. Especifica o caminho de pesquisa literal que este arquivo foi resolvido de.
ResolvedFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém uma lista de todas as referências primárias resolvido para caminhos completos. Opcionalmente, os itens neste parâmetro contêm os metadados de item a seguir: CopyLocal: Booleanvalor. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: Stringvalor. Especifica o nome para essa dependência. ResolvedFrom: Stringvalor. Especifica o caminho de pesquisa literal que este arquivo foi resolvido de.
SatelliteFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Especifica quaisquer arquivos satélite encontrados. Esses serão CopyLocal = true se a referência ou dependência que causou este item existir CopyLocal = true. Opcionalmente, os itens neste parâmetro contêm os metadados de item a seguir: CopyLocal: Booleanvalor. Indica se a referência fornecida deve ser copiada para o diretório de saída. Esse valor é true se a referência ou dependência que causou este item existir tem um CopyLocal o valor de true. DestinationSubDirectory: Stringvalor. Especifica o diretório de destino relativo para copiar este item.
ScatterFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém os arquivos de dispersão associados a um dos assemblies determinados. Opcionalmente, os itens neste parâmetro contêm os metadados de item a seguir: CopyLocal: Booleanvalor. Indica se a referência fornecida deve ser copiada para o diretório de saída.
SearchPaths	Obrigatório String[] parâmetro. Especifica as pastas ou locais especiais que são pesquisados para encontrar os arquivos no disco que representam os assemblies. A ordem na qual os caminhos de pesquisa são listados é importante. Para cada assembly, lista de caminhos é pesquisada da esquerda para a direita. Quando um arquivo que representa o assembly for encontrado, que pesquisa pára e a pesquisa para o próximo inicia de assembly. Esse parâmetro aceita os seguintes tipos de valores: Um caminho de diretório. {HintPathFromItem}: Especifica que a tarefa examinará o HintPath metadados do item base. {CandidateAssemblyFiles}: Especifica que a tarefa examinará os arquivos passados através do CandidateAssemblyFiles parâmetro. {Do registro: _AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: {AssemblyFolders}: Especifica que a tarefa usará o esquema de localizar assemblies do registro do Visual Studio.NET de 2003. {GAC:} Especifica que a tarefa irá procurar no GAC. {RawFileName}: Especifica que a tarefa irá considerar a Include o valor do item a ser um caminho exato e o nome de arquivo.
SerializationAssemblyFiles	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém os assemblies de serialização de XML encontrados. Esses itens são marcados CopyLocal = true se e somente se a referência ou dependência que causou este item existir é CopyLocal = true. O Boolean metadados CopyLocal indica se a referência fornecida deve ser copiada para o diretório de saída.
Silent	Opcional Boolean parâmetro. Se true, não há mensagens são registradas. O valor padrão é false.
StateFile	Opcional String parâmetro. Especifica o estado para esta tarefa de criar um nome de arquivo que indica onde salvar intermediários.
SuggestedRedirects	Opcional ITaskItem[] parâmetro de saída de somente leitura. Contém um item para cada conflitantes assembly identidade distinta, independentemente do valor da AutoUnify parâmetro. Isso inclui cada cultura e PKT encontrado não tinha uma entrada bindingRedirect adequado no arquivo de configuração do aplicativo. Opcionalmente, cada item contém as seguintes informações: Includeatributo: Contém o nome completo da família de assembly com um valor de campo de versão 0.0.0.0 MaxVersionmetadados de item: Contém o número máximo de versão.
TargetedRuntimeVersion	Opcional String parâmetro. Especifica a versão de tempo de execução para o destino, por exemplo, 2.0.57027 ou v2.0.57027.
TargetFrameworkDirectories	Opcional String[] parâmetro. Especifica o caminho do diretório do framework de destino. Este parâmetro é necessário para determinar o status CopyLocal de itens resultantes. Se este parâmetro não for especificado, nenhum item resultante ser terá um CopyLocal valor de true a menos que explicitamente tenham uma Private o valor de metadados de true em seu item de origem.
TargetFrameworkMoniker	Opcional String parâmetro. TargetFrameworkMoniker para monitorar, se houver. Isso é usado para fazer logon.
TargetFrameworkMonikerDisplayName	Opcional String parâmetro. O nome de exibição do TargetFrameworkMoniker para monitorar, se houver. Isso é usado para fazer logon.
TargetFrameworkSubsets	Opcional String[] parâmetro. Contém uma lista de nomes de subconjunto de estrutura de destino a ser procurado em diretórios de estrutura de destino.
TargetFrameworkVersion	Opcional String parâmetro. A versão de framework de destino do projeto. O valor padrão é vazio, o que significa que não há nenhuma filtragem para as referências com base na estrutura de destino.
TargetProcessorArchitecture	Opcional String parâmetro. A arquitetura de processador de destino preferido. Usado para resolver referências de Cache de Assembly Global (GAC). Este parâmetro pode ter um valor de x86, IA64 ou AMD64. Se este parâmetro estiver ausente, a tarefa primeiro considera os assemblies que coincidem com a arquitetura do processo em execução no momento. Se nenhum assembly for encontrado, a tarefa considera assemblies no GAC que têm ProcessorArchitecture valor de MSIL ou nenhuma ProcessorArchitecture valor.

Comentários

Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension , a própria classe herda o Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de TaskExtension.

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild