-reference (Visual Basic)

  • Статья

Дает компилятору указание сделать всю информацию о типах из указанных сборок доступной компилируемому проекту.

Синтаксис

-reference:fileList

or

-r:fileList

Аргументы

Термин Определение
fileList Обязательный. Список всех имен файлов сборки, разделенных запятыми. Если имя файла содержит пробел, заключите его в кавычки.

Замечания

Импортируемые файлы должны содержать метаданные сборки. За пределами сборки видны только открытые типы. Параметр -addmodule импортирует метаданные из модуля.

При ссылке на сборку (сборка А), которая, в свою очередь, ссылается на другую сборку (сборка Б), необходимо ссылаться на сборку Б в следующих случаях.

  • Тип из сборки A наследуется из типа или реализует интерфейс сборки Б.

  • Вызывается поле, свойство, событие или метод, имеющий тип возвращаемого значения или тип параметра из сборки Б.

Для указания каталога, в котором находятся одна или несколько ссылок на сборки, используется параметр -libpath.

Чтобы компилятор распознал тип в сборке (а не модуль), необходимо принудительно разрешить тип. Это можно сделать различными способами, например, определив экземпляр типа. Существуют другие способы разрешения имен типов в сборке для компилятора. Например, при наследовании от типа в сборке имя типа будет станет известно компилятору.

По умолчанию используется файл ответов Vbc.rsp, который ссылается на часто используемые сборки .NET Framework. Параметр -noconfig позволяет запретить компилятору использовать файл Vbc.rsp.

Краткой формой -reference является -r.

Пример

Следующая команда компилирует исходный файл Input.vb и ссылочные сборки из Metad1.dll и Metad2.dll и создает файл Out.exe.

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

См. также