Tarefa ResolveAssemblyReference

Determina a todos os assemblies que dependem de assemblies especificados. Isso inclui o segundo e ndependências de ordem th.

Parâmetros

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

Parâmetro	Descrição
AllowedAssemblyExtensions	Opcional String[] parâmetro. As extensões de nome de arquivo do assembly 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 Pesquisar 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 do qual deseja analisar e extrair bindingRedirect mapeamentos. Se este parâmetro for especificado, a AutoUnify o parâmetro deve ser false.
Assemblies	Opcional ITaskItem[] parâmetro. Especifica os itens para o qual caminhos completos e dependências devem ser identificadas. Esses itens podem ter nomes simples como "Sistema" ou nomes de alta seguras como "sistema, versão = 2.0.3500.0, cultura = neutral, PublicKeyToken = b77a5c561934e089." Itens passadas para esse parâmetro podem ter opcionalmente seguintes metadados de item: Private: Boolean valor. If true, em seguida, o item será copiado localmente. O valor padrão é true. HintPath: String valor. Especifica o nome de arquivo e caminho a ser usado sistema autônomo uma referência. Isso é usado quando {HintPathFromItem} for especificado no SearchPaths parâmetro. O valor padrão é uma sequência vazia. SpecificVersion: Boolean valor. If true, e em seguida, o nome exato especificado na Include atributo deve coincidir. If false, em seguida, qualquer assembly irá funcionar com o mesmo nome simples. If SpecificVersion não for especificado, e, em seguida, a tarefa examina o valor de Include atributo do item. Se o atributo é um nome simples, ele se comporta sistema autônomo se SpecificVersion foi false. Se o atributo é um nome forte, ele se comporta sistema autônomo se SpecificVersion foi true. ExecutableExtension: String valor. Quando estiver 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: String valor. Apenas 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: String valor. Esses metadados é suportado para fins de legado. Ele especifica uma chave de registro definidas pelo usuário, sistema autônomo "hklm\VendorFolder", that Assemblies deve usar para resolver referências de assembly.
AssemblyFiles	Opcional ITaskItem[] parâmetro. Especifica uma lista de assemblies totalmente qualificados para o qual você deseja encontrar dependências. Itens passadas para esse parâmetro podem ter opcionalmente seguintes metadados de item: Private: um recurso opcional Boolean valor. Se verdadeiro, o item será copiado localmente. FusionName: opcional String metadados. Especifica o nome simples ou de alta segurança para este item. Se este atributo estiver presente, ele pode economizar time porque não tem o arquivo de montagem a ser aberto para obter o nome.
AutoUnify	Opcional Boolean parâmetro. If true, o gráfico de dependência resultante automaticamente é tratado sistema autônomo se houvesse um App. arquivo de configuração passado para o parâmetro AppConfigFile. Este arquivo app.config virtual tem uma entrada bindingRedirect para cada conjunto de módulos (assemblies) em conflito para que o assembly de versão mais alto é escolhido. Um resultado disso é que nunca haverá um aviso sobre assemblies em conflito porque cada conflito serão resolvidos. Cada remapeamento distintas fará com que um comentário de alta prioridade que indica que as versões antiga e novas e o fato de que isso foi concluído automaticamente porque AutoUnify foi true. If false, nenhuma versão de assembly remapeamento ocorrerá automaticamente. Quando existem duas versões de um assembly, haverá um aviso. Cada conflito distinto entre versões diferentes do mesmo assembly fará com que um comentário de alta prioridade. Depois que todos esses comentários são exibidos, haverá um único aviso com um único erro código e texto que lê “ encontrados 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 módulos (assemblies) a ser usado para o processo de resolução e Pesquisar. Valores passados para este parâmetro devem ser nomes de arquivo absoluto ou nomes de arquivo relativos ao projeto. Assemblies nesta lista serão considerados quando o SearchPaths parâmetro contém {CandidateAssemblyFiles} sistema autônomo um dos caminhos a serem considerados.
CopyLocalFiles	Opcional ITaskItem[] parâmetro de saída somente leitura. Retorna todos os arquivos no ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, e ScatterFiles parâmetros que tem 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. If true, as dependências serão encontradas. Caso contrário, somente referências principais são encontradas. O valor padrão é true.
FindRelatedFiles	Opcional Boolean parâmetro. If true, relacionados a arquivos sistema autônomo arquivos .pdb e arquivos .xml serão encontrados. O valor padrão é true.
FindSatellites	Opcional Boolean parâmetro. If true, assemblies satélites serão encontrados. O valor padrão é true.
FindSerializationAssemblies	Opcional Boolean parâmetro. If true, em seguida, a tarefa procura por assemblies de serialização. O valor padrão é true.
FullTargetFrameworkSubsetNames	Opcional String[] parâmetro. Contém uma lista de nomes de subconjunto de estrutura de destino. Se um nome de subconjunto na lista corresponde a um no TargetFrameworkSubset a propriedade Name e, em seguida, o sistema exclui esse subconjunto de estrutura de destino específico no momento da compilação.
IgnoreDefaultInstalledAssemblyTables	Opcional Boolean parâmetro. If true, e, em seguida, a tarefa procura 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. If true, e, em seguida, a tarefa procura e usos adicionais instalados assembly subconjunto tabelas (ou "Subconjunto listas") 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 especifica os assemblies que deverão estar no subconjunto de destino. sistema autônomo opção, sistema autônomo itens desta lista podem especificar sistema autônomo metadados "FrameworkDirectory" para associar umInstalledAssemblySubsetTable com um diretório específico da estrutura. Se houver apenas um TargetFrameworkDirectorieselemento e, em seguida, todos sistema autônomo itens nesta lista que não têm metadados "FrameworkDirectory" são tratados sistema autônomo se estivessem conjunto sistema autônomo o valor exclusivo que é passado para TargetFrameworkDirectories.
InstalledAssemblyTables	Opcional String parâmetro. Contém uma lista de arquivos XML que especifica os assemblies que são esperados ser instalados no computador de destino. Quando InstalledAssemblyTables é conjunto, versões anteriores dos conjuntos de módulos (assemblies) na lista são mescladas em versões mais recentes relacionadas no XML. Além disso, os assemblies que têm uma seletiva conjunto de InGAC = 'true' são considerados pré-requisitos e são conjunto a CopyLocal = 'false' a menos que explicitamente substituída. sistema autônomo opção, sistema autônomo itens desta lista podem especificar metadados "FrameworkDirectory" para associar umInstalledAssemblyTable com um diretório específico da estrutura. No entanto, essa configuração é ignorada a menos que o nome de redist começa com "Microsoft-Windows-CLRCoreComp". Se houver apenas um TargetFrameworkDirectorieselemento e, em seguida, todos sistema autônomo itens nesta lista que não têm metadados "FrameworkDirectory" são tratados sistema autônomo se eles estão configurados com o valor exclusivo que é passado to TargetFrameworkDirectories.
RelatedFiles	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém arquivos relacionados, sistema autônomo arquivos XML e .pdb que têm o mesmo nome base sistema autônomo uma referência. Os arquivos listados neste parâmetro opcionalmente podem conter os seguintes metadados de item: Primary: Boolean valor. If true, e, em seguida, o item do arquivo foi passado para o array, usando o Assemblies parâmetro. Valor padrão é false. CopyLocal: Boolean valor. 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 n th ordem caminhos para as dependências. Este parâmetro não inclui a primeira ordem principal referências, que estão contidas no ResolvedFiles parâmetro. Os itens neste parâmetro opcionalmente contêm os metadados de item seguinte: CopyLocal: Boolean valor. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: String valor. Especifica o nome para essa dependência. ResolvedFrom: String valor. Especifica o caminho de Pesquisar literal esse arquivo foi resolvido no.
ResolvedFiles	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém uma lista de todas as referências principais resolvido para caminhos completos. Os itens neste parâmetro opcionalmente contêm os metadados de item seguinte: CopyLocal: Boolean valor. Indica se a referência fornecida deve ser copiada para o diretório de saída. FusionName: String valor. Especifica o nome para essa dependência. ResolvedFrom: String valor. Especifica o caminho de Pesquisar literal esse arquivo foi resolvido no.
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 for CopyLocal = true. Os itens neste parâmetro opcionalmente contêm os metadados de item seguinte: CopyLocal: Boolean valor. 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 valor de true. DestinationSubDirectory: String valor. 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 conjuntos de módulos (assemblies) determinado. Os itens neste parâmetro opcionalmente contêm os metadados de item seguinte: CopyLocal: Boolean valor. Indica se a referência fornecida deve ser copiada para o diretório de saída.
SearchPaths	Necessário String[] parâmetro. Especifica diretórios ou locais especiais são pesquisados para localizar os arquivos no disco que representam os assemblies. A ordem na qual os caminhos de Pesquisar são listados é importante. Para cada assembly, a lista de caminhos é pesquisada da esquerda para a direita. Quando um arquivo que representa o assembly for encontrado, que pesquisar 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 de item base. {CandidateAssemblyFiles}: Especifica que a tarefa examinará os arquivos passados a 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 2003. {GAC}: Especifica que a tarefa irá procurar no GAC. {RawFileName}: Especifica que a tarefa irá considerar a Include valor do item a ser um nome de arquivo e caminho exato.
Silent	Opcional Boolean parâmetro. If true, não há mensagens são registradas. O valor padrão é false.
StateFile	Opcional String parâmetro. Especifica um nome de arquivo que indica onde salvar intermediários Criar estado para esta tarefa.
SuggestedRedirects	Opcional ITaskItem[] parâmetro de saída somente leitura. Contém um item para cada distintas identidade de assembly conflitante, independentemente do valor do 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: Include atributo: Contém o nome completo da família assembly com um valor do campo de versão de 0.0.0.0 MaxVersion metadados de item: Contém o número de versão máxima.
TargetFrameworkDirectories	Opcional String[] parâmetro. Especifica o caminho do diretório de destino estrutura. 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 valor CopyLocal true a menos que explicitamente tenham um Private valor de metadados de true em seu item de fonte.
TargetFrameworkSubsets	Opcional String[] parâmetro. Contém uma lista de nomes de subconjunto de estrutura de destino a ser pesquisado nos 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 não há nenhuma filtragem para as referências com base na estrutura de destino.
TargetProcessorArchitecture	Opcional String parâmetro. A arquitetura do processador alvo preferencial. Usado para resolver referências de GAC (cache de assemblies global). 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 coincide com a arquitetura do processo em execução no momento. Se nenhum assembly for encontrado, a tarefa considera assemblies no GAC com ProcessorArchitecture valor de MSIL ou nenhuma ProcessorArchitecture valor.

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild

Date	History	Motivo
Julho de 2008	Adicionado estes parâmetros: AllowedAssemblyExtensions AllowedRelatedFileExtensions FindSerializationAssemblies FullTargetFrameworkSubsetNames IgnoreDefaultInstalledAssemblyTables IgnoreDefaultInstalledAssemblySubsetTables InstalledAssemblySubsetTables InstalledAssemblyTables TargetFrameworkSubsets TargetFrameworkVersion	Alteração de recurso do SP1.