-reference (Visual Basic)

  • Artigo

Faz com que o compilador disponibilize as informações de tipo nos assemblies especificados para o projeto sendo compilado no momento.

Syntax

-reference:fileList

ou

-r:fileList

Argumentos

Termo Definição
fileList Obrigatórios. Lista delimitada por vírgulas de nomes de arquivo do assembly. Se o nome do arquivo contém um espaço, coloque o nome entre aspas.

Comentários

Os arquivos importados devem conter metadados de assembly. Somente tipos públicos são visíveis fora do assembly. A opção -addmodule importa metadados de um módulo.

Se você referenciar um assembly (Assembly A) que referencia outro assembly (Assembly B), será necessário referenciar o Assembly B se:

  • Um tipo do Assembly A herda de um tipo ou implementa uma interface do Assembly B.

  • Um campo, propriedade, evento ou método que tem um tipo de retorno ou de parâmetro do Assembly B é invocado.

Use -libpath para especificar o diretório no qual uma ou mais das suas referências do assembly estão localizadas.

Para o compilador reconhecer um tipo em um assembly (não um módulo), ele deve ser forçado a resolver o tipo. Um exemplo de como você pode fazer isso é definir uma instância do tipo. Outras maneiras estão disponíveis para resolver nomes de tipo em um assembly para o compilador. Por exemplo, se você herdar de um tipo em um assembly, o nome do tipo se tornará conhecido pelo compilador.

O arquivo de resposta Vbc.rsp, que referencia assemblies .NET Framework usados com frequência, é usado por padrão. Use -noconfig se você não quiser que o compilador use Vbc.rsp.

A forma abreviada de -reference é -r.

Exemplo

A linha de comando a seguir compila o arquivo de origem Input.vb e faz referência aos assemblies de Metad1.dll e Metad2.dll para produzir Out.exe.

vbc -reference:metad1.dll,metad2.dll -out:out.exe input.vb

Confira também