Общие свойства проекта MSBuild
В следующей таблице перечислены часто используемые свойства, определенные в файлах проекта Visual Studio или включенные в .targets файлы, предоставляемые MSBuild.
Файлы проекта в Visual Studio (CSPROJ, .vbproj, .vcxprojи другие) содержат XML-код MSBuild, который выполняется при сборке проекта с помощью интегрированной среды разработки. Проекты обычно импортируют один или несколько целевых объектов .targets для определения процесса сборки. Дополнительные сведения см. в файлах MSBuild .targets.
При задании значений свойств следует помнить, что общие свойства могут быть заданы, сбрасываются или используются в нескольких импортированных файлах. Поэтому важно, когда вы устанавливаете свойство в файле проекта, в Directory.Build.propsили в другом импортированном файле. Если вы задаете свойство где-то и не получаете ожидаемый результат, рассмотрите, где и как свойство изменяется или используется во всех файлах, импортированных проектом, включая импорты, которые добавляются неявно при использовании атрибута Sdk. См. Выбор между добавлением свойств в файл .props или .targets. Предварительная обработка может помочь в этом (см. параметр командной строки /preprocess или /pp на справочнике по командной строке MSBuild).
Список общих свойств и параметров
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| ДополнительныеLibPaths | .СЕТЬ | Указывает дополнительные папки, в которых компиляторы должны искать эталонные сборки. |
| AddModules | .СЕТЬ | Компилятор делает все сведения о типе из указанных файлов доступными для скомпилированного проекта. Это свойство эквивалентно коммутатору компилятора /addModules. |
| ALToolPath | .СЕТЬ | Путь к AL.exe. Это свойство переопределяет текущую версию AL.exe, чтобы включить использование другой версии. |
| ApplicationIcon | .СЕТЬ | Файл значка .ico, который передается компилятору для внедрения в виде значка Win32. Свойство эквивалентно коммутатору компилятора /win32icon. |
| ApplicationManifest | Все | Указывает путь к файлу, который используется для создания сведений о манифесте внешнего элемента управления учетными записями пользователей (UAC). Применяется только к проектам Visual Studio, предназначенным для Windows Vista. В большинстве случаев манифест внедрен. Однако если вы используете развертывание COM или ClickOnce бесплатной регистрации, манифест может быть внешним файлом, установленным вместе с сборками приложения. Дополнительные сведения см. в свойстве NoWin32Manifest в этой статье. |
| AssemblyOriginatorKeyFile | .СЕТЬ | Указывает файл, используемый для подписи сборки (.snk или .pfx), и передается задаче ResolveKeySource для создания фактического ключа, используемого для подписи сборки. |
| AssemblySearchPaths | .СЕТЬ | Список расположений для поиска во время разрешения эталонной сборки во время сборки. Порядок отображения путей в этом списке имеет смысл, так как пути, перечисленные ранее, имеют приоритет над последующими записями. |
| Имя сборки | .СЕТЬ | Имя окончательной выходной сборки после построения проекта. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| BaseAddress | .СЕТЬ | Указывает базовый адрес основной выходной сборки. Это свойство эквивалентно коммутатору компилятора /baseaddress. |
| BaseIntermediateOutputPath | Все | Папка верхнего уровня, в которой создаются все промежуточные папки выходных данных для конкретной конфигурации. Значение по умолчанию — obj\. Следующий код является примером: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath> |
| BaseOutputPath | Все | Указывает базовый путь для выходного файла. Если он задан, MSBuild использует OutputPath = $(BaseOutputPath)\$(Configuration)\. Пример синтаксиса: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
| BuildInParallel | Все | Логическое значение, указывающее, создаются ли ссылки на проекты параллельно или очищаются при использовании Multi-Proc MSBuild. Значение по умолчанию — true, что означает, что проекты будут создаваться параллельно, если система имеет несколько ядер или процессоров. |
| BuildProjectReferences | Все | Логическое значение, указывающее, создаются ли ссылки на проекты с помощью MSBuild. Автоматически устанавливается значение false, если вы создаете проект в интегрированной среде разработки Visual Studio (IDE), true, если в противном случае.
-p:BuildProjectReferences=false можно указать в командной строке, чтобы избежать проверки актуальности ссылочных проектов. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| CleanFile | Все | Имя файла, который будет использоваться в качестве "чистого кэша". Чистый кэш — это список созданных файлов, которые необходимо удалить во время операции очистки. Файл помещается в промежуточный выходной путь процессом сборки. Это свойство указывает только имена файлов, у которых нет сведений о пути. |
| CodePage | .СЕТЬ | Указывает кодовую страницу, используемую для всех файлов исходного кода в компиляции. Это свойство эквивалентно коммутатору компилятора /codepage. |
| КомпиляторResponseFile | .СЕТЬ | Необязательный файл ответа, который можно передать задачам компилятора. |
| Конфигурация | Все | Конфигурация, которую вы создаете, обычно Debug или Release, но настраиваемая на уровне решения и проекта. |
| CscToolPath | C# | Путь к csc.exeкомпилятору C#. |
| CustomAfterMicrosoftCommonTargets | Все | Имя файла проекта или целевого файла, импортируемого автоматически после импорта общих целевых объектов. |
| CustomBeforeMicrosoftCommonTargets | Все | Имя файла проекта или целевого файла, импортируемого автоматически перед импортом общих целевых объектов. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| DebugSymbols | Все | Логическое значение, указывающее, создаются ли символы сборкой. Установка -p:DebugSymbols=false в командной строке отключает создание файлов символов базы данных программы (PDB) . |
| DebugType | Все | Определяет уровень отладочной информации, которую вы хотите создать. Допустимые значения: "full", "pdbonly", "portable", "embedded" и "none". |
| ОпределениеConstants | .СЕТЬ | Определяет константы условного компилятора. Пары символов и значений разделены точкой с запятой и задаются с помощью синтаксиса, зависящее от языка: C#: symbol1; symbol2Visual Basic: symbol1 = value1, symbol2 = value2Свойство эквивалентно коммутатору компилятора /define. |
| DefineDebug | Все | Логическое значение, указывающее, определена ли константа DEBUG. |
| DefineTrace | Все | Логическое значение, указывающее, определена ли константа TRACE. |
| DelaySign | .СЕТЬ | Логическое значение, указывающее, нужно ли подписывать сборку, а не полностью подписывать ее. |
| Детерминированный | .СЕТЬ | Логическое значение, указывающее, должен ли компилятор создавать идентичные сборки для идентичных входных данных. Этот параметр соответствует /deterministic коммутатору компиляторов. |
| DirectoryBuildPropsPath | Все | Указывает путь к файлу Directory.Build.props; Если определено, это свойство переопределяет алгоритм поиска по умолчанию. См. настройкасборки. |
| DirectoryBuildTargetsPath | Все | Указывает путь к файлу Directory.Build.targets; Если определено, это свойство переопределяет алгоритм поиска по умолчанию. См. настройкасборки. |
| DisableFastUpToDateCheck | Все | Логическое значение, применимое только к Visual Studio. Диспетчер сборок Visual Studio использует процесс с именем FastUpToDateCheck, чтобы определить, должен ли проект быть перестроен в актуальном состоянии. Этот процесс быстрее, чем с помощью MSBuild для определения этого. Установка свойства DisableFastUpToDateCheck для true позволяет обойти диспетчер сборок Visual Studio и принудительно применить MSBuild для определения актуальности проекта. |
| DocumentationFile | .СЕТЬ | Имя файла, созданного в виде XML-файла документации. Это имя включает только имя файла и не содержит сведений о пути. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| ErrorReport | .СЕТЬ | Указывает, как задача компилятора должна сообщать об ошибках внутреннего компилятора. Допустимые значения: "запрос", "отправить" или "нет". Это свойство эквивалентно коммутатору компилятора /errorreport. |
| ExcludeDeploymentUrl | .СЕТЬ | Задача GenerateDeploymentManifest добавляет тег deploymentProvider в манифест развертывания, если файл проекта содержит любой из следующих элементов: — UpdateUrl — InstallUrl — PublishUrl Однако с помощью ExcludeDeploymentUrl можно запретить добавлению тега deploymentProvider в манифест развертывания, даже если указан любой из указанных выше URL-адресов. Для этого добавьте в файл проекта следующее свойство: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Примечание. ExcludeDeploymentUrl не предоставляется в интегрированной среде разработки Visual Studio и можно задать только путем редактирования файла проекта вручную. Установка этого свойства не влияет на публикацию в Visual Studio; То есть тег deploymentProvider по-прежнему будет добавлен в URL-адрес, указанный в PublishUrl. |
| FileAlignment | .СЕТЬ | Указывает в байтах, где выровнять разделы выходного файла. Допустимые значения: 512, 1024, 2048, 4096, 8192. Это свойство эквивалентно коммутатору компилятора /filealignment. |
| FrameworkPathOverride | Visual Basic | Указывает расположение mscorlib.dll и microsoft.visualbasic.dll. Этот параметр эквивалентен параметру /sdkpath компилятора vbc.exe. |
| GenerateDocumentationFile | .СЕТЬ | Логический параметр, указывающий, создается ли документация сборкой. Если true, сборка создает сведения о документации и помещает его в файл .xml вместе с именем исполняемого файла или библиотеки, созданной задачей сборки. |
| GenerateFullPaths | C# | Создайте полные пути для имен файлов в выходных данных с помощью параметра компилятора -fullpaths. |
| GenerateSerializationAssemblies | .СЕТЬ | Указывает, следует ли создавать сборки сериализации XML с помощью SGen.exe, которые можно задать для включения, автоматического или выключения. Это свойство используется для сборок, предназначенных только для .NET Framework. Чтобы создать сборки сериализации XML для сборок .NET Standard или .NET Core, см. ссылку на пакет NuGet Microsoft.XmlSerializer.Generator. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| ImportDirectoryBuildProps | Все | Логическое значение, указывающее, следует ли импортировать файл Directory.Build.props. См. настройкасборки. |
| ImportDirectoryBuildTargets | Все | Логическое значение, указывающее, следует ли импортировать файл Directory.Build.targets. См. настройкасборки. |
| IntermediateOutputPath | Все | Полный промежуточный выходной путь, производный от BaseIntermediateOutputPath, если путь не указан. Например, obj\debug\. |
| KeyContainerName | Все | Имя контейнера ключей строгого имени. |
| KeyOriginatorFile | Все | Имя файла ключа строгого имени. |
| ModuleAssemblyName | .СЕТЬ | Имя сборки, в которую необходимо включить скомпилированный модуль. Свойство эквивалентно коммутатору компилятора /moduleassemblyname. |
| MSBuildProjectExtensionsPath | Все | Указывает путь, в котором находятся расширения проекта. По умолчанию это значение принимает то же значение, что и BaseIntermediateOutputPath. |
| MSBuildTreatWarningsAsErrors | Все | Логическое значение, указывающее MSBuild обрабатывать все предупреждения как ошибки, если они не подавляются. |
| MSBuildWarningsAsErrors | Все | Указывает список кодов предупреждений для обработки как ошибок. Разделите несколько предупреждений точкой с запятой. Если вы используете свойство пакета SDK для .NET WarningsAsErrors, MSBuildWarningsAsErrors по умолчанию будет использоваться значение WarningsAsErrors. |
| MSBuildWarningsAsMessages | Все | Задает список кодов предупреждений для подавления, рассматривая их как сообщения с низкой важностью. Разделите несколько предупреждений точкой с запятой. Обратите внимание, что некоторые предупреждения, создаваемые MSBuild, нельзя отключить с помощью этого свойства; чтобы отключить их, используйте параметр командной строки -warnAsMessage. Если вы используете свойство пакета SDK для .NET NoWarn, MSBuildWarningsAsMessages по умолчанию будет использоваться значение NoWarn. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| NoLogo | Все | Логическое значение, указывающее, следует ли отключить логотип компилятора. Это свойство эквивалентно коммутатору компилятора /nologo. |
| NoStdLib | .СЕТЬ | Логическое значение, указывающее, следует ли избегать ссылки на стандартную библиотеку (mscorlib.dll). Значение по умолчанию — false. |
| NoVBRuntimeReference | Visual Basic | Логическое значение, указывающее, должна ли среда выполнения Visual Basic (Microsoft.VisualBasic.dll) включаться в проект в качестве ссылки. |
| NoWarn | .СЕТЬ | Подавляет указанные предупреждения. Необходимо указать только числовую часть идентификатора предупреждения. Несколько предупреждений разделены точкой с запятой. Этот параметр соответствует /nowarn коммутатору компиляторов. |
| NoWin32Manifest | .СЕТЬ | Логическое значение, указывающее, будут ли данные манифеста управления учетными записями (UAC) внедрены в исполняемый файл приложения. Применяется только к проектам Visual Studio, предназначенным для Windows Vista. В проектах, развернутых с помощью ClickOnce и Registration-Free COM, этот элемент игнорируется.
False (значение по умолчанию) указывает, что сведения о манифесте контроля учетных записей пользователей (UAC) будут внедрены в исполняемый файл приложения.
True указывает, что сведения о манифесте UAC не внедрены.Это свойство применяется только к проектам Visual Studio, предназначенным для Windows Vista. В проектах, развернутых с помощью ClickOnce и Registration-Free COM, это свойство игнорируется. Добавить NoWin32Manifest следует только в том случае, если Visual Studio не требует внедрения каких-либо сведений манифеста в исполняемый файл приложения; этот процесс вызывается виртуализации. Чтобы использовать виртуализацию, задайте <ApplicationManifest> в сочетании с <NoWin32Manifest> следующим образом:— Для проектов Visual Basic удалите узел <ApplicationManifest>. (В проектах Visual Basic <NoWin32Manifest> игнорируется при наличии узла <ApplicationManifest>.)— Для проектов C# задайте для <ApplicationManifest> значение False и <NoWin32Manifest> значение True. (В проектах C# <ApplicationManifest> переопределяет <NoWin32Manifest>.)Это свойство эквивалентно параметру компилятора /nowin32manifestvbc.exe. |
| Оптимизировать | .СЕТЬ | Логическое значение, которое при значении trueвключает оптимизацию компилятора. Это свойство эквивалентно коммутатору компилятора /optimize. |
| OptionCompare | VisualBasic | Указывает, как выполняются сравнения строк. Допустимыми значениями являются двоичные или текстовые. Это свойство эквивалентно параметру компилятора /optioncomparevbc.exe. |
| OptionExplicit | Visual Basic | Логическое значение, которое при значении trueтребует явного объявления переменных в исходном коде. Это свойство эквивалентно коммутатору компилятора /optionexplicit. |
| OptionInfer | Visual Basic | Логическое значение, указывающее значение true, позволяет выводить переменные типа. Это свойство эквивалентно коммутатору компилятора /optioninfer. |
| OptionStrict | Visual Basic | Логическое значение, которое при значении true, приводит к тому, что задача сборки принудительно применяет семантику строгого типа для ограничения неявных преобразований типов. Это свойство эквивалентно параметру /optionstrict компилятора vbc.exe. |
| OutDir | Все | Указывает окончательное расположение выходных данных для проекта или решения. При создании решения OutDir можно использовать для сбора нескольких выходных данных проекта в одном расположении. Кроме того, OutDir включен в AssemblySearchPaths, используемый для разрешения ссылок. Например, bin\Debug. |
| OutputPath | Все | Указывает путь к выходному каталогу относительно каталога проекта, например, bin\Debug или bin\Debug\$(Platform) в сборках, отличных от AnyCPU. |
| OutputType | Все | Указывает формат файла выходного файла. Этот параметр может иметь одно из следующих значений: -Библиотека. Создает библиотеку кода. (Значение по умолчанию.) - Exe. Создает консольное приложение. -Модуль. Создает модуль. - Winexe. Создает программу на основе Windows. Для C# и Visual Basic это свойство эквивалентно параметру /target. Тип вывода можно автоматически переопределить путем вывода. См. раздел OutputType с значением WinExe для приложений WPF и WinForms. Отключите вывод, задав DisableWinExeOutputInference значение true. |
| OverwriteReadOnlyFiles | Все | Логическое значение, указывающее, следует ли включить сборку для перезаписи файлов только для чтения или вызвать ошибку. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| PathMap | .СЕТЬ | Указывает, как сопоставить физические пути с именами исходных путей, выходными данными компилятора. Это свойство эквивалентно /pathmap коммутатору компиляторов. |
| PdbFile | .СЕТЬ | Имя файла PDB файла, который вы генерируете. Это свойство эквивалентно параметру /pdb компилятора csc.exe. |
| Платформа | Все | Операционная система, для которую вы создаете. Примерами для сборок .NET Framework являются "Любой ЦП", "x86" и "x64". |
| ProcessorArchitecture | .СЕТЬ | Архитектура процессора, используемая при разрешении ссылок на сборки. Допустимые значения: msil, x86, amd64 или ia64. |
| ProduceOnlyReferenceAssembly | .СЕТЬ | Логическое значение, указывающее компилятору выдавать только эталонную сборку, а не скомпилированный код. Невозможно использовать в сочетании с ProduceReferenceAssembly. Это свойство соответствует /refonly коммутатору vbc.exe и компиляторам csc.exe. |
| ProduceReferenceAssembly | .СЕТЬ | Логическое значение, которое, если задано значение true, позволяет создавать эталонные сборки для текущей сборки.
Deterministic следует true при использовании этой функции. Это свойство соответствует /refout коммутатору vbc.exe и компиляторам csc.exe. |
| RegisterAssemblyMSBuildArchitecture | Только Windows | Указывает архитектуру по умолчанию, для которой зарегистрирована управляемая библиотека DLL. Это свойство полезно, так как COM использует реестр Windows для хранения регистраций в кустах, относящихся к архитектуре. Например, в системе Windows управляемая сборка AnyCPU может иметь свои типы, зарегистрированные в 64-разрядном кусте и /или в 32-разрядном кусте (WoW), а сборка использует это свойство для определения используемого куста реестра для конкретной архитектуры. Допустимые значения: x86, x64 и ARM64. |
| RegisterForCOMInterop | Только Windows | Указывает, что управляемое приложение будет предоставлять com-объект (вызываемая оболочка COM). См. страницу сборки — раздел вывода. Этот параметр влияет только на компьютер, на котором строится проект. Если вы развертываете на других компьютерах, вызовите regasm.exe, чтобы зарегистрировать сборку на целевом компьютере. |
| RemoveIntegerChecks | Visual Basic | Логическое значение, указывающее, следует ли отключить проверки ошибок переполнения целых чисел. Значение по умолчанию — false. Это свойство эквивалентно параметру /removeintchecks компилятора vbc.exe. |
| RootNamespace | Все | Корневое пространство имен, используемое при имени внедренного ресурса. Это пространство имен является частью внедренного имени манифеста ресурса. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| Satellite_AlgorithmId | .СЕТЬ | Идентификатор алгоритма хэширования AL.exe, используемого при создании вспомогательных сборок. |
| Satellite_BaseAddress | .СЕТЬ | Базовый адрес, используемый при создании вспомогательных сборок с учетом языка и региональных параметров с помощью целевого объекта CreateSatelliteAssemblies. |
| Satellite_CompanyName | .СЕТЬ | Имя компании, передаваемой в AL.exe во время создания вспомогательной сборки. |
| Satellite_Configuration | .СЕТЬ | Имя конфигурации для передачи в AL.exe во время создания вспомогательной сборки. |
| Satellite_Description | .СЕТЬ | Текст описания для передачи в AL.exe во время создания вспомогательной сборки. |
| Satellite_EvidenceFile | .СЕТЬ | Внедряет указанный файл в вспомогательной сборке с именем ресурса Security.Evidence. |
| Satellite_FileVersion | .СЕТЬ | Задает строку для поля "Версия файла" в вспомогательной сборке. |
| Satellite_Flags | .СЕТЬ | Задает значение поля Flags в вспомогательной сборке. |
| Satellite_GenerateFullPaths | .СЕТЬ | Вызывает задачу сборки использовать абсолютные пути для всех файлов, сообщаемого в сообщении об ошибке. |
| Satellite_LinkResource | .СЕТЬ | Связывает указанные файлы ресурсов со вспомогательной сборкой. |
| Satellite_MainEntryPoint | .СЕТЬ | Указывает полное имя метода (то есть class.method), используемое в качестве точки входа при преобразовании модуля в исполняемый файл во время создания вспомогательной сборки. |
| Satellite_ProductName | .СЕТЬ | Задает строку для поля Product в вспомогательной сборке. |
| Satellite_ProductVersion | .СЕТЬ | Задает строку для поля ProductVersion в вспомогательной сборке. |
| Satellite_TargetType | .СЕТЬ | Задает формат файла выходного файла вспомогательной сборки как библиотеку, exe или win. Значением по умолчанию является библиотека. |
| Satellite_Title | .СЕТЬ | Задает строку для поля Title в вспомогательной сборке. |
| Satellite_Trademark | .СЕТЬ | Задает строку для поля "Товарный знак" в вспомогательной сборке. |
| Satellite_Version | .СЕТЬ | Указывает сведения о версии для вспомогательной сборки. |
| Satellite_Win32Icon | .СЕТЬ | Вставляет файл значка .ico в вспомогательной сборке. |
| Satellite_Win32Resource | .СЕТЬ | Вставляет ресурс Win32 (RES-файл) в вспомогательную сборку. |
| SGenToolPath | .СЕТЬ | Необязательный путь к инструменту, указывающий, где получить SGen.exe при переопределении текущей версии SGen.exe. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| SGenUseProxyTypes | .СЕТЬ | Логическое значение, указывающее, должны ли типы прокси-серверов создаваться SGen.exe. Это применяется только в том случае, если GenerateSerializationAssemblies включен. Целевой объект SGen использует это свойство для задания флага UseProxyTypes. Это свойство по умолчанию имеет значение true, и пользовательский интерфейс не изменяется. Чтобы создать сборку сериализации для типов веб-служб, добавьте это свойство в файл проекта и задайте значение false перед импортом Microsoft.Common.Targets или C#/VB.targets. |
| SkipInvalidConfigurations | Все | При trueсоздайте предупреждение на недопустимых сочетаниях платформ и конфигураций, но не завершайте сборку; при false или неопределенном (по умолчанию) возникает ошибка. |
| StartupObject | .СЕТЬ | Указывает класс или модуль, содержащий процедуру Main или Sub Main. Это свойство эквивалентно коммутатору компилятора /main. |
| ПодсистемаVersion | .СЕТЬ | Указывает минимальную версию подсистемы, которую может использовать созданный исполняемый файл. Это свойство эквивалентно коммутатору компилятора /subsystemversion. Сведения о значении по умолчанию этого свойства см. в /subsystemversion (Visual Basic) или /subsystemversion (параметры компилятора C#). |
| TargetCompactFramework | .СЕТЬ | Версия .NET Compact Framework, необходимая для запуска приложения, которое вы создаете. Указание этого позволяет ссылаться на некоторые сборки платформы, на которые вы не сможете ссылаться в противном случае. |
| TargetFrameworkVersion | .СЕТЬ | Версия .NET Framework, необходимая для запуска приложения, которое вы создаете. Указание этого позволяет ссылаться на некоторые сборки платформы, на которые вы не сможете ссылаться в противном случае. |
| TreatWarningsAsErrors | .СЕТЬ | Логический параметр, который, если true, вызывает все предупреждения, которые будут рассматриваться как ошибки. Этот параметр эквивалентен параметру компилятора /nowarn. |
| UseCommonOutputDirectory | .СЕТЬ | Логическое свойство, которое можно задать для true, если требуется, чтобы все выходные данные сборки в решении использовали один и тот же выходной каталог. Если true, выходные данные ссылочных проектов не копируются в проекты, использующие эти зависимости, как правило, в случае, если этот параметр false. Установка этого параметра на true не изменяет фактический выходной каталог каких-либо проектов; Вам по-прежнему нужно задать выходной каталог для нужного общего выходного каталога для каждого проекта, который требует его. |
| UseHostCompilerIfAvailable | .СЕТЬ | Логический параметр, который, если true, вызывает задачу сборки для использования объекта компилятора в процессе, если он доступен. Этот параметр используется только Visual Studio. |
| Utf8Output | .СЕТЬ | Логический параметр, который, если true, регистрирует выходные данные компилятора с помощью кодировки UTF-8. Этот параметр эквивалентен параметру компилятора /utf8Output. |
| Имя свойства или параметра | Типы проектов | Описание |
|---|---|---|
| VbcToolPath | Visual Basic | Необязательный путь, указывающий другое расположение для vbc.exe при переопределении текущей версии vbc.exe. |
| VbcVerbosity | Visual Basic | Указывает детализацию выходных данных компилятора Visual Basic. Допустимые значения: "Тихая", "Обычный" (значение по умолчанию) или "Подробный". |
| VisualStudioVersion | Все | Указывает версию Visual Studio, в которой должен быть запущен этот проект. Если это свойство не указано, MSBuild задает для него значение по умолчанию {VisualStudioMajorVersion}.0; например, он будет 17.0 для всех версий Visual Studio 2022.Это свойство используется в нескольких типах проектов для указания набора целевых объектов, используемых для сборки. Если ToolsVersion имеет значение 4.0 или более поздней версии для проекта, VisualStudioVersion используется для указания используемого вложенного набора инструментов. Дополнительные сведения см. в разделе Toolset (ToolsVersion). |
| ПредупрежденияAsErrors | .СЕТЬ | Задает список предупреждений, которые следует рассматривать как ошибки. Этот параметр эквивалентен параметру компилятора /warnaserror. |
| WarningLevel | Все | Указывает уровень предупреждения, который передается компилятору для предупреждений, создаваемых компилятором. Этот параметр не влияет на предупреждения MSBuild, которые не имеют обозначений уровня. См. уровня предупреждения в документации по компилятору C# и /W (уровень предупреждения) в документации по компилятору C++. |
| WarningsNotAsErrors | .СЕТЬ | Указывает список предупреждений, которые не рассматриваются как ошибки. Этот параметр эквивалентен параметру компилятора /warnaserror. |
| Win32Manifest | .СЕТЬ | Имя файла манифеста, который должен быть внедрен в окончательную сборку. Этот параметр эквивалентен параметру компилятора /win32Manifest. |
| Win32Resource | .СЕТЬ | Имя файла ресурса Win32, внедренного в окончательную сборку. Этот параметр эквивалентен параметру компилятора /win32resource. |
Свойства, относящиеся к проектам пакета SDK для .NET, например TargetFramework, описаны в свойствах Framework.