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

В MSBuildMSBuild элемент представляет собой именованную ссылку на один или несколько файлов.In MSBuildMSBuild, an item is a named reference to one or more files. Элементы содержат метаданные, такие как имена файлов, пути и номера версий.Items contain metadata such as file names, paths, and version numbers. Все типы проектов в Visual StudioVisual Studio имеют по несколько общих элементов.All project types in Visual StudioVisual Studio have several items in common. Эти элементы определены в файле Microsoft.Build.CommonTypes.xsd.These items are defined in the file Microsoft.Build.CommonTypes.xsd.

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

Ниже приведен список общих элементов проекта.The following is a list of all the common project items.

СсылкаReference

Представляет ссылку на сборку (управляемую) в проекте.Represents an assembly (managed) reference in the project.

Имя метаданных элементаItem metadata name ОписаниеDescription
УказаниеПутиHintPath Необязательная строка.Optional string. Относительный или абсолютный путь к сборке.Relative or absolute path of the assembly.
nameName Необязательная строка.Optional string. Отображаемое имя сборки, например "System.Windows.Forms".The display name of the assembly, for example, "System.Windows.Forms."
FusionИмяFusionName Необязательная строка.Optional string. Задает простое или строгое fusion-имя элемента.Specifies the simple or strong fusion name for the item.

Если этот атрибут присутствует, экономится время, поскольку для получения fusion-имени не нужно открывать файл сборки.When this attribute is present, it can save time because the assembly file does not have to be opened to obtain the fusion name.
УказаннаяВерсияSpecificVersion Необязательный логический атрибут.Optional boolean. Указывает, дается ли ссылка только на версию в fusion-имени.Specifies whether only the version in the fusion name should be referenced.
ПсевдонимыAliases Необязательная строка.Optional string. Любые псевдонимы для ссылки.Any aliases for the reference.
PrivatePrivate Необязательный логический атрибут.Optional boolean. Указывает, будет ли ссылка скопирована в папку выходных данных.Specifies whether the reference should be copied to the output folder. Этот атрибут соответствует свойству Копировать локально ссылки, находящейся в интегрированной среде разработки Visual Studio.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

СсылкаНаCOMCOMReference

Представляет ссылку на COM-компонент (неуправляемый) в проекте.Represents a COM (unmanaged) component reference in the project.

Имя метаданных элементаItem metadata name ОписаниеDescription
nameName Необязательная строка.Optional string. Отображаемое имя компонента.The display name of the component.
GuidGuid Обязательная строка.Required string. Идентификатор GUID для компонента в формате {12345678-1234-1234-1234-1234567891234}.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor Обязательная строка.Required string. Основная часть номера версии компонента.The major part of the version number of the component. Например "5", если полный номер версии — "5.46".For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor Обязательная строка.Required string. Вспомогательная часть номера версии компонента.The minor part of the version number of the component. Например "46", если полный номер версии — "5.46".For example, "46" if the full version number is "5.46."
LCIDLCID Необязательная строка.Optional string. Код языка для компонента.The LocaleID for the component.
ИнструментОберткиWrapperTool Необязательная строка.Optional string. Имя инструмента обертки, используемое в компоненте, например "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."
ИзолированныеIsolated Необязательный логический атрибут.Optional boolean. Указывает, является ли компонент компонентом, для которого не требуется регистрация.Specifies whether the component is a reg-free component.

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

Представляет список библиотек типов, которые загружаются в целевой объект РазрешеннаяСсылкаНаCom.Represents a list of type libraries that feed into the ResolvedComreference target.

Имя метаданных элементаItem metadata name ОписаниеDescription
ИнструментОберткиWrapperTool Необязательная строка.Optional string. Имя инструмента обертки, используемое в компоненте, например "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."

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

Представляет машинный файл манифеста или ссылку на такой файл.Represents a native manifest file or a reference to such a file.

Имя метаданных элементаItem metadata name ОписаниеDescription
nameName Обязательная строка.Required string. Базовое имя файла манифеста.The base name of the manifest file.
УказаниеПутиHintPath Обязательная строка.Required string. Относительный путь к файлу манифеста.The relative path of the manifest file.

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

Представляет ссылку на другой проект.Represents a reference to another project.

Имя метаданных элементаItem metadata name ОписаниеDescription
nameName Необязательная строка.Optional string. Отображаемое имя ссылки.The display name of the reference.
ПроектProject Необязательная строка.Optional string. Идентификатор GUID для ссылки в формате {12345678-1234-1234-1234-1234567891234}.A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
ПакетPackage Необязательная строка.Optional string. Путь к файлу проекта, на который указывает ссылка.The path of the project file that is being referenced.
ReferenceOutputAssemblyReferenceOutputAssembly Необязательный логический атрибут.Optional boolean. Если задано значение false, в ссылку на проект не включаются его выходные данные. Но по-прежнему обеспечивается создание других проектов перед этим проектом.If set to false, does not include the output of the referenced project as a Reference of this project, but still ensures that the other project builds before this one. По умолчанию — true.Defaults to true.

КомпиляторCompile

Представляет исходные файлы для компилятора.Represents the source files for the compiler.

Имя метаданных элементаItem metadata name ОписаниеDescription
ЗависимостьОтDependentUpon Необязательная строка.Optional string. Указывает файл, от которого зависит этот файл, для правильной компиляции.Specifies the file this file depends on to compile correctly.
АвтоСозданиеAutoGen Необязательный логический атрибут.Optional boolean. Указывает, был ли файл проекта создан интегрированной средой разработки (IDE) Visual StudioVisual Studio.Indicates whether the file was generated for the project by the Visual StudioVisual Studio integrated development environment (IDE).
СсылкаLink Необязательная строка.Optional string. Отображаемый путь к обозначениям, если файл физически расположен вне зоны влияния файла проекта.The notational path to be displayed when the file is physically located outside the influence of the project file.
ВидимыйVisible Необязательный логический атрибут.Optional boolean. Указывает, следует ли отображать файл в обозревателе решений в Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
КопироватьВВыходнойКаталогCopyToOutputDirectory Необязательная строка.Optional string. Определяет, следует ли копировать файл в выходной каталог.Determines whether to copy the file to the output directory. Доступны следующие значения:Values are:

1. Никогда1. Never
2. Всегда2. Always
3. СохранятьНовейшие3. PreserveNewest

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

Представляет ресурсы для внедрения в созданную сборку.Represents resources to be embedded in the generated assembly.

Имя метаданных элементаItem metadata name ОписаниеDescription
ЗависимостьОтDependentUpon Необязательная строка.Optional string. Указывает файл, от которого зависит этот файл для правильной компиляции.Specifies the file this file depends on to compile correctly
GeneratorGenerator Обязательная строка.Required string. Имя любого генератора файлов, который запущен на этом элементе.The name of any file generator that is run on this item.
ПоследниеВыходныеДанныеГенератораLastGenOutput Обязательная строка.Required string. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.The name of the file that was created by any file generator that ran on this item.
НастраиваемоеПространствоИменСредстваCustomToolNamespace Обязательная строка.Required string. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.The namespace in which any file generator that runs on this item should create code.
СсылкаLink Необязательная строка.Optional string. Путь к обозначениям отображается в том случае, если файл физически расположен вне зоны влияния проекта.The notational path is displayed if the file is physically located outside the influence of the project.
ВидимыйVisible Необязательный логический атрибут.Optional boolean. Указывает, следует ли отображать файл в обозревателе решений в Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
КопироватьВВыходнойКаталогCopyToOutputDirectory Необязательная строка.Optional string. Определяет, следует ли копировать файл в выходной каталог.Determines whether to copy the file to the output directory. Доступны следующие значения:Values are:

1. Никогда1. Never
2. Всегда2. Always
3. СохранятьНовейшие3. PreserveNewest
ЛогическоеИмяLogicalName Обязательная строка.Required string. Логическое имя внедренного ресурса.The logical name of the embedded resource.

ContentContent

Представляет файлы, которые не компилируются в проект, но могут быть внедрены или опубликованы вместе с ним.Represents files that are not compiled into the project, but may be embedded or published together with it.

Имя метаданных элементаItem metadata name ОписаниеDescription
ЗависимостьОтDependentUpon Необязательная строка.Optional string. Указывает файл, от которого зависит этот файл, для правильной компиляции.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Обязательная строка.Required string. Имя любого генератора файлов, который запущен на этом элементе.The name of any file generator that runs on this item.
ПоследниеВыходныеДанныеГенератораLastGenOutput Обязательная строка.Required string. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.The name of the file that was created by any file generator that was run on this item.
НастраиваемоеПространствоИменСредстваCustomToolNamespace Обязательная строка.Required string. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.The namespace in which any file generator that runs on this item should create code.
СсылкаLink Необязательная строка.Optional string. Путь к обозначениям, который отображается в том случае, если файл физически расположен вне зоны влияния проекта.The notational path to be displayed if the file is physically located outside the influence of the project.
СостояниеПубликацииPublishState Обязательная строка.Required string. Состояние публикации содержимого либо:The publish state of the content, either:

— Default- Default
— Included- Included
— Excluded- Excluded
— DataFile- DataFile
— Prerequisite- Prerequisite
ЯвляетсяСборкойIsAssembly Необязательный логический атрибут.Optional boolean. Указывает, является ли файл сборкой.Specifies whether the file is an assembly.
ВидимыйVisible Необязательный логический атрибут.Optional boolean. Указывает, следует ли отображать файл в обозревателе решений в Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
КопироватьВВыходнойКаталогCopyToOutputDirectory Необязательная строка.Optional string. Определяет, следует ли копировать файл в выходной каталог.Determines whether to copy the file to the output directory. Доступны следующие значения:Values are:

1. Никогда1. Never
2. Всегда2. Always
3. СохранятьНовейшие3. PreserveNewest

НетNone

Представляет файлы, которые не должны иметь никакой роли в процессе создания.Represents files that should have no role in the build process.

Имя метаданных элементаItem metadata name ОписаниеDescription
ЗависимостьОтDependentUpon Необязательная строка.Optional string. Указывает файл, от которого зависит этот файл, для правильной компиляции.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Обязательная строка.Required string. Имя любого генератора файлов, который запущен на этом элементе.The name of any file generator that is run on this item.
ПоследниеВыходныеДанныеГенератораLastGenOutput Обязательная строка.Required string. Имя файла, который был создан любым генератором файлов, запущенным на этом элементе.The name of the file that was created by any file generator that ran on this item.
НастраиваемоеПространствоИменСредстваCustomToolNamespace Обязательная строка.Required string. Пространство имен, в котором любой генератор файлов, запущенный на этом элементе, должен создать код.The namespace in which any file generator that runs on this item should create code.
СсылкаLink Необязательная строка.Optional string. Путь к обозначениям, который отображается в том случае, если файл физически расположен вне зоны влияния проекта.The notational path to be displayed if the file is physically located outside the influence of the project.
ВидимыйVisible Необязательный логический атрибут.Optional boolean. Указывает, следует ли отображать файл в обозревателе решений в Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
КопироватьВВыходнойКаталогCopyToOutputDirectory Необязательная строка.Optional string. Определяет, следует ли копировать файл в выходной каталог.Determines whether to copy the file to the output directory. Доступны следующие значения:Values are:

1. Никогда1. Never
2. Всегда2. Always
3. СохранятьНовейшие3. PreserveNewest

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

Представляет базовый манифест приложения для сборки и содержит сведения о безопасности развертывания ClickOnceClickOnce.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

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

Представляет проект FxCop для импорта.Represents the FxCop project to import.

ИмпортImport

Представляет сборки, пространства имен которых должен импортировать компилятор Visual BasicVisual Basic.Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

См. такжеSee also