Поделиться через

Общие элементы проектов MSBuild

  • Статья

В MSBuild элемент представляет собой именованную ссылку на один или несколько файлов. Элементы содержат метаданные, такие как имена файлов, пути и номера версий. Все типы проектов в Visual Studio имеют по несколько общих элементов. Эти элементы определены в файле в microsoft.build.commontypes.xsd.

Общие элементы

Ниже приведен список общих элементов проекта.

Ссылки

Представляет ссылку на сборку (управляемую) в проекте.

Имя элемента

Описание

УказаниеПути

Необязательная строка. Относительный или абсолютный путь к сборке.

Имя

Необязательная строка. Отображаемое имя сборки, например "System.Windows.Forms".

FusionИмя

Необязательная строка. Задает простое или строгое fusion-имя элемента.

Если этот атрибут присутствует, экономится время, поскольку для получения fusion-имени не нужно открывать файл сборки.

УказаннаяВерсия

Необязательный логический атрибут. Указывает, дается ли ссылка только на версию в fusion-имени.

Псевдонимы

Необязательная строка. Любые псевдонимы для ссылки.

Закрытый

Необязательная строка. Определяет, следует ли копировать файл в выходной каталог. Доступны следующие значения:

  1. Никогда

  2. Всегда

  3. СохранятьНовейшие

СсылкаНаCOM

Представляет ссылку на COM-компонент (неуправляемый) в проекте.

Имя элемента

Описание

Имя

Необязательная строка. Отображаемое имя компонента.

Guid

Необязательная строка. Идентификатор GUID для компонента в формате {12345678-1234-1234-1234-1234567891234}.

VersionMajor

Необязательная строка. Основная часть номера версии компонента. Например "5", если полный номер версии — "5.46".

VersionMinor

Необязательная строка. Вспомогательная часть номера версии компонента. Например "46", если полный номер версии — "5.46".

Код языка

Необязательная строка. Код языка для компонента.

ИнструментОбертки

Необязательная строка. Имя инструмента обертки, используемое в компоненте, например "tlbimp".

Изолированные

Необязательный логический атрибут. Указывает, является ли компонент компонентом, для которого не требуется регистрация.

СсылкаНаCOMФайл

Представляет список библиотек типов, которые загружаются в целевой объект РазрешеннаяСсылкаНаCom.

Имя элемента

Описание

ИнструментОбертки

Необязательная строка. Имя инструмента обертки, используемое в компоненте, например "tlbimp".

СобственнаяСсылка

Представляет машинный файл манифеста или ссылку на такой файл.

Имя элемента

Описание

Имя

Обязательная строка. Базовое имя файла манифеста.

УказаниеПути

Обязательная строка. Относительный путь к файлу манифеста.

СсылкаНаПроект

Представляет ссылку на другой проект.

Имя элемента

Описание

Имя

Необязательная строка. Отображаемое имя ссылки.

Project

Необязательная строка. Идентификатор GUID для ссылки в формате {12345678-1234-1234-1234-1234567891234}.

Пакет

Необязательная строка. Путь к файлу проекта, на который указывает ссылка.

Компилятор

Представляет исходные файлы для компилятора.

Имя элемента

Описание

ЗависимостьОт

Необязательная строка. Указывает файл, от которого зависит этот файл, для правильной компиляции.

АвтоСоздание

Необязательный логический атрибут. Указывает, был ли файл проекта создан интегрированной средой разработки (IDE) Visual Studio.

Ссылка

Необязательная строка. Отображаемый путь к обозначениям, если файл физически расположен вне зоны влияния файла проекта.

Показывается

Необязательный логический атрибут. Указывает, следует ли отображать файл в Обозревателе решений в Visual Studio.

КопироватьВВыходнойКаталог

Необязательная строка. Определяет, следует ли копировать файл в выходной каталог. Доступны следующие значения:

  1. Никогда

  2. Всегда

  3. СохранятьНовейшие

ВнедренныйРесурс

Представляет ресурсы для внедрения в созданную сборку.

Имя элемента

Описание

ЗависимостьОт

Необязательная строка. Указывает файл, от которого зависит этот файл, для правильной компиляции.

Generator

Обязательная строка. Имя любого генератора файлов, который запущен на этом элементе.

ПоследниеВыходныеДанныеГенератора

Обязательная строка. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.

НастраиваемоеПространствоИменСредства

Обязательная строка. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.

Ссылка

Необязательная строка. Путь к обозначениям отображается в том случае, если файл физически расположен вне зоны влияния проекта.

Показывается

Необязательный логический атрибут. Указывает, следует ли отображать файл в Обозревателе решений в Visual Studio.

КопироватьВВыходнойКаталог

Необязательная строка. Определяет, следует ли копировать файл в выходной каталог. Доступны следующие значения:

  1. Никогда

  2. Всегда

  3. СохранятьНовейшие

ЛогическоеИмя

Обязательная строка. Логическое имя внедренного ресурса.

Content

Представляет файлы, которые не компилируются в проект, но могут быть внедрены или опубликованы вместе с ним.

Имя элемента

Описание

ЗависимостьОт

Необязательная строка. Указывает файл, от которого зависит этот файл, для правильной компиляции.

Generator

Обязательная строка. Имя любого генератора файлов, который запущен на этом элементе.

ПоследниеВыходныеДанныеГенератора

Обязательная строка. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.

НастраиваемоеПространствоИменСредства

Обязательная строка. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.

Ссылка

Необязательный логический атрибут. Указывает, следует ли отображать файл в Обозревателе решений в Visual Studio.

СостояниеПубликации

Обязательная строка. Состояние публикации содержимого либо:

  • По умолчанию

  • Включено

  • Исключено

  • ФайлДанных

  • Предварительные требования

ЯвляетсяСборкой

Необязательный логический атрибут. Указывает, является ли файл сборкой.

Показывается

Необязательный логический атрибут. Указывает, следует ли отображать файл в Обозревателе решений в Visual Studio.

КопироватьВВыходнойКаталог

Необязательная строка. Определяет, следует ли копировать файл в выходной каталог. Доступны следующие значения:

  1. Никогда

  2. Всегда

  3. СохранятьНовейшие

Нет

Представляет файлы, которые не должны иметь никакой роли в процессе создания.

Имя элемента

Описание

ЗависимостьОт

Необязательная строка. Указывает файл, от которого зависит этот файл, для правильной компиляции.

Generator

Обязательная строка. Имя любого генератора файлов, который запущен на этом элементе.

ПоследниеВыходныеДанныеГенератора

Обязательная строка. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.

НастраиваемоеПространствоИменСредства

Обязательная строка. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.

Ссылка

Необязательная строка. Путь к обозначениям, который отображается в том случае, если файл физически расположен вне зоны влияния проекта.

Показывается

Необязательный логический атрибут. Указывает, следует ли отображать файл в Обозревателе решений в Visual Studio.

КопироватьВВыходнойКаталог

Необязательная строка. Определяет, следует ли копировать файл в выходной каталог. Доступны следующие значения:

  1. Никогда

  2. Всегда

  3. СохранятьНовейшие

БазовыйМанифестПриложения

Представляет базовый манифест приложения для сборки и содержит сведения о безопасности развертывания ClickOnce.

ИмпортАнализаКода

Представляет проект FxCop для импорта.

Импорт

Представляет сборки, пространства имен которых должен импортировать компилятор Visual Basic.

См. также

Ссылки

Общие свойства проектов MSBuild