Tarefa ResolveAssemblyReference

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

Parâmetros

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

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 para 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 a criação de assemblies, como 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 conflitante conjunto de módulos (assemblies) de modo 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 diferentes versões de referência e assemblies dependentes".
Assemblies	Opcional ITaskItem[] parâmetro. Especifica os itens para os quais as dependências e caminhos completos devem ser identificadas. Esses itens podem ter 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: Boolean value. Se true, e em seguida, o item será copiado localmente. O valor padrão é true. HintPath: String value. 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: Boolean value. Se true, e em seguida, o nome exato especificado na Include atributo deve corresponder. Se false, e em seguida, qualquer assembly com o mesmo nome simples funcionará. Se SpecificVersion não for especificado, e em seguida, 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 for 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 é resolvido somente se fusion coincide exatamente com o Include atributo. Quando um destinos do projeto uma.NET Framework versão e referências 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 faz referência a um assembly que não está no perfil, a referência resolve apenas se ele tem SpecificVersion definido como true. ExecutableExtension: String value. Quando estiver presente, o assembly resolvido deve ter esta extensão. Quando ausente, e. dll é considerada em primeiro lugar, seguido por. exe, para cada diretório de inspeção. SubType: String value. Somente os itens com metadados de subtipo vazio serão resolvidos em caminhos completos de assembly. Itens com metadados de subtipo não vazio são ignorados. AssemblyFolderKey: String value. Esses metadados há suporte para fins de legado. Ele especifica uma chave de registro definidas 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 não possui o arquivo de montagem a ser aberto para obter o nome.
AutoUnify	Opcional Boolean parâmetro. Se true, o gráfico de dependência resultante automaticamente é tratado como se houvesse um arquivo app. config passado para o parâmetro AppConfigFile. Este arquivo virtual do App. config tem uma entrada bindingRedirect para cada conflitante conjunto de módulos (assemblies) para que o assembly de versão mais alto é escolhido. Um resultado disto é 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 diferentes versões de referência e assemblies dependentes". O valor padrão é false.
CandidateAssemblyFiles	Opcional String[] parâmetro. Especifica uma lista de módulos (assemblies) a ser usado para o processo de pesquisa e resolução. 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 só se aplica a 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, pois 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 é verdadeiro ou falso, 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 somente leitura. Retorna todos os arquivos do ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, e ScatterFiles parâmetros que tenha CopyLocal 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 pesquisa para assemblies de serialização. O valor padrão é true.
FullFrameworkAssemblyTables	Opcional ITaskItem[] parâmetro. Especifica os itens que possuem metadados de "FrameworkDirectory" 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 RedistList. Este diretório representa a estrutura completa para um perfil de determinado cliente, por exemplo, o diretório %programfiles%\reference 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 nome de propriedade, e em seguida, o sistema exclui esse subconjunto de estrutura de destino específico no momento da compilação.
IgnoreDefaultInstalledAssemblyTables	Opcional Boolean parâmetro. Se true, em seguida, a tarefa de pesquisa e usos adicionais instalados assembly tabelas (ou "Listas Redist") que são encontrados no diretório de \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 de \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 deverão estar no subconjunto de destino. Como opção, os itens nesta lista podem especificar os metadados de "FrameworkDirectory" para associar umInstalledAssemblySubsetTable com um diretório específico do framework. Se houver apenas um TargetFrameworkDirectories elemento e, em seguida, todos os itens nesta lista que não possuem os metadados de "FrameworkDirectory" 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 no 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 metadados de "FrameworkDirectory" para associar um InstalledAssemblyTable com um diretório específico do 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 e, em seguida, todos os itens nesta lista que não possuem os metadados de "FrameworkDirectory" são tratados como se elas são definidas como 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 recente que pode ser alvo na máquina. Se isso não é definido mais alto framework instalada no computador para 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 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: Boolean value. Se true, e em seguida, o item do arquivo foi passado para a matriz, usando o Assemblies parâmetro. Valor padrão é false. CopyLocal: Boolean value. Indica se a referência fornecida deve ser copiada para o diretório de saída.
ResolvedDependencyFiles	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém o ncaminhos de ordem th dependências. Este parâmetro não inclui primeira referências primário ordem, que estão contidas no ResolvedFiles parâmetro. Opcionalmente, os itens neste parâmetro contêm os metadados de item a seguir: CopyLocal: Boolean value. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: String value. Especifica o nome para essa dependência. ResolvedFrom: String value. Especifica o caminho de pesquisa literal que este arquivo foi resolvido de.
ResolvedFiles	Opcional ITaskItem[] parâmetro de saída 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: Boolean value. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: String value. Especifica o nome para essa dependência. ResolvedFrom: String value. Especifica o caminho de pesquisa literal que este arquivo foi resolvido de.
SatelliteFiles	Opcional ITaskItem[] parâmetro de saída 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: Boolean value. 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 para existir tem um CopyLocal valor de true. DestinationSubDirectory: String value. Especifica o diretório de destino relativo para copiar este item para.
ScatterFiles	Opcional ITaskItem[] parâmetro de saída 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: Boolean value. 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 será interrompida e a procura da próxima inicialização do assembly. Esse parâmetro aceita os seguintes tipos de valores: Um caminho de diretório. {HintPathFromItem}: Especifica que a tarefa examinará a HintPath metadados do item base. {CandidateAssemblyFiles}: Especifica que a tarefa examinará os arquivos transmitidos por meio do CandidateAssemblyFiles parâmetro. {Do registro: _AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: {AssemblyFolders}: Especifica a tarefa usará o esquema Localizando assemblies do registro do Visual Studio.NET 2003. {GAC}: Especifica a tarefa irá procurar no GAC. {RawFileName}: Especifica a tarefa irá considerar a Include o valor do item a ser um nome de arquivo e caminho exato.
SerializationAssemblyFiles	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém qualquer 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 o local onde deseja salvar os intermediários.
SuggestedRedirects	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém um item para cada distintas identidade de assembly conflitante, independentemente do valor da AutoUnify parâmetro. Isso inclui cada cultura e PKT que foi encontrado e que 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 assembly com um valor de campo de versão 0.0.0.0 MaxVersionos metadados 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 um Private o valor de metadados de true em seu item de origem.
TargetFrameworkMoniker	Opcional String parâmetro. O 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 estrutura de destino do projeto. O valor padrão é vazio, o que significa que há sem 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 Global Assembly Cache (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 possuam o ProcessorArchitecture valor de MSIL ou nenhuma ProcessorArchitecture valor.

Comentários

Com os parâmetros listados acima, esta tarefa herda os parâmetros da TaskExtension herda de classe, que por si só a Task classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe TaskExtension (base).

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência das tarefas do MSBuild