.CSProj вариант №

Файлы с расширением CSPROJ представляют собой файл проекта C#, который содержит список файлов, включенных в проект, а также ссылки на системные сборки. Когда новый проект инициируется в Microsoft VIiual Studio, вы получаете один файл .csproj вместе с основным файлом решения (.sln). Если в проекте более одной сборки, будет равное количество файлов проекта, а файл .sln связывает их все вместе как часть проекта. Содержимое этого файла определяет все требования, необходимые для построения проекта, такие как включаемый контент, требования к платформе, информация о версиях, настройки веб-сервера или сервера базы данных, а также задачи, которые необходимо выполнить. Содержимое файла проекта представлено в формате файла XML и может быть открыто в любом текстовом редакторе как для редактирования, так и для просмотра. Это также дает логическое представление файлам проекта для правильного расположения.

Формат файла CSPROJ

Разработчики также могут создавать файлы проектов самостоятельно, соблюдая схему XML MSBuild. Открытая и прозрачная структура файлов проектов позволяет разработчикам приложений осуществлять сложный и детальный контроль над созданием и развертыванием проектов. Содержимое такого файла проекта имеет очень четкую взаимосвязь между собой. На следующем рисунке показаны ключевые элементы и отношения между ними для такого файла проекта.

В следующих разделах подробно описаны элементы формата файла для файла проекта.

Элемент проекта

Элемент Project является корневым элементом каждого файла проекта. Он идентифицирует схему XML для файла проекта и может включать атрибуты для указания точек входа для процесса сборки.

<Project ToolsVersion#"4.0" DefaultTargets#"FullPublish"
        xmlns#"http://schemas.microsoft.com/developer/msbuild/2003">
</Project>

Свойства и условия

Свойства представляют собой необходимую информацию, необходимую для построения проекта. Такие свойства определяются в элементе PropertyGroup. Эти свойства состоят из пар ключ-значение, где имя элемента свойства определяет ключ свойства, а содержимое элемента определяет значение свойства. Например, вы можете определить свойства с именами ServerName и ConnectionString для хранения статического имени сервера и строки подключения.

<PropertyGroup>    
 <ServerName>FABRIKAM\TEST1</ServerName>
 <ConnectionString>
     Data Source#FABRIKAM\TESTDB;InitialCatalog#ContactManager,...
 </ConnectionString>
</PropertyGroup>

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

<PropertyGroup>
<OutputRoot Condition#" '$(OutputRoot)'##'' ">..\Publish\Out\</OutputRoot>
   ...
</PropertyGroup>

Когда MSBuild обрабатывает это определение свойства, она сначала проверяет, доступно ли значение свойства $(OutputRoot). Если значение свойства пустое (другими словами, пользователь не указал значение для этого свойства), условие оценивается как true, а значение свойства устанавливается на ..\Publish\Out.

Элементы и группы элементов

Файл проекта определяет входные данные для процесса сборки, которые на самом деле являются файлами разных типов. В номенклатуре MSBuild эти входные данные представлены элементами Item и определены в элементе ItemGroup. Как и в случае с элементами Property, вы можете назвать элемент Item как угодно. Однако вы должны указать атрибут Include, чтобы идентифицировать файл или подстановочный знак, который представляет элемент.

<ItemGroup>
<ProjectsToBuild Include#"$(SourceRoot)ContactManager-WCF.sln"/>
</ItemGroup>

Цели и задачи

Элемент Task представляет отдельную инструкцию сборки (или задачу). MSBuild включает в себя множество предопределенных задач. Например:

  • Задача Копировать копирует файлы в новое место.
  • Задача Csc вызывает компилятор Visual C#.
  • Задача Vbc вызывает компилятор Visual Basic.
  • Задача Exec запускает указанную программу.
  • Задача Сообщение записывает сообщение в регистратор.

Задачи всегда должны содержаться в элементах Target. Элемент Target — это набор из одной или нескольких задач, которые выполняются последовательно, а файл проекта может содержать несколько целей.

<Project xmlns#"http://schemas.microsoft.com/developer/msbuild/2003">
<Target Name#"LogMessage">
 <Message Text#"Hello world!" />
</Target>
</Project>

использованная литература

See Also