일반적인 MSBuild 프로젝트 항목Common 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 Name 설명Description
HintPathHintPath 선택적 문자열입니다.Optional string. 어셈블리의 상대 또는 절대 경로입니다.Relative or absolute path of the assembly.
이름Name 선택적 문자열입니다.Optional string. 어셈블리의 표시 이름(예: "System.Windows.Forms")입니다.The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName 선택적 문자열입니다.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.
SpecificVersionSpecificVersion 선택적 부울입니다.Optional boolean. Fusion 이름의 버전만 참조할지 여부를 지정합니다.Specifies whether only the version in the fusion name should be referenced.
별칭Aliases 선택적 문자열입니다.Optional string. 참조에 대한 별칭입니다.Any aliases for the reference.
전용Private 선택적 부울입니다.Optional boolean. 참조를 출력 폴더에 복사할지 여부를 지정합니다.Specifies whether the reference should be copied to the output folder. 이 특성은 Visual Studio IDE에 있는 참조의 로컬 복사 속성과 일치합니다.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

프로젝트의 COM(비관리) 구성 요소 참조를 나타냅니다.Represents a COM (unmanaged) component reference in the project.

항목 이름Item Name 설명Description
이름Name 선택적 문자열입니다.Optional string. 구성 요소의 표시 이름입니다.The display name of the component.
GuidGuid 선택적 문자열입니다.Optional string. 구성 요소의 GUID로, {12345678-1234-1234-1234-1234567891234} 형식을 갖습니다.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor 선택적 문자열입니다.Optional string. 구성 요소 버전 번호의 주 버전 부분입니다.The major part of the version number of the component. 예를들어 전체 버전 번호가 "5.46"이면 "5"입니다.For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor 선택적 문자열입니다.Optional string. 구성 요소 버전 번호의 부 버전 부분입니다.The minor part of the version number of the component. 예를들어 전체 버전 번호가 "5.46"이면 "46"입니다.For example, "46" if the full version number is "5.46."
LCIDLCID 선택적 문자열입니다.Optional string. 구성 요소의 LocaleID입니다.The LocaleID for the component.
WrapperToolWrapperTool 선택적 문자열입니다.Optional string. 구성 요소에 사용되는 래퍼 도구의 이름(예: "tlbimp")입니다.The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsolatedIsolated 선택적 부울입니다.Optional boolean. 등록이 필요 없는 구성 요소인지 여부를 지정합니다.Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

ResolvedComreference 대상에 공급되는 형식 라이브러리 목록을 나타냅니다.Represents a list of type libraries that feed into the ResolvedComreference target.

항목 이름Item Name 설명Description
WrapperToolWrapperTool 선택적 문자열입니다.Optional string. 구성 요소에 사용되는 래퍼 도구의 이름(예: "tlbimp")입니다.The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

네이티브 매니페스트 파일 또는 이러한 파일에 대한 참조를 나타냅니다.Represents a native manifest file or a reference to such a file.

항목 이름Item Name 설명Description
이름Name 필수 문자열입니다.Required string. 매니페스트 파일의 기본 이름입니다.The base name of the manifest file.
HintPathHintPath 필수 문자열입니다.Required string. 매니페스트 파일의 상대 경로입니다.The relative path of the manifest file.

ProjectReferenceProjectReference

다른 프로젝트에 대한 참조를 나타냅니다.Represents a reference to another project.

항목 이름Item Name 설명Description
이름Name 선택적 문자열입니다.Optional string. 참조의 표시 이름입니다.The display name of the reference.
ProjectProject 선택적 문자열입니다.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.

CompileCompile

컴파일러에 대한 소스 파일을 나타냅니다.Represents the source files for the compiler.

항목 이름Item Name 설명Description
DependentUponDependentUpon 선택적 문자열입니다.Optional string. 올바르게 컴파일하기 위해 이 파일이 의존하는 파일을 지정합니다.Specifies the file this file depends on to compile correctly.
AutoGenAutoGen 선택적 부울입니다.Optional boolean. Visual StudioVisual Studio IDE(통합 개발 환경)에서 프로젝트를 위해 해당 파일이 생성되었는지 여부를 나타냅니다.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.
CopyToOutputDirectoryCopyToOutputDirectory 선택적 문자열입니다.Optional string. 출력 디렉터리에 파일을 복사할지 여부를 결정합니다.Determines whether to copy the file to the output directory. 값:Values are:

1. Never1. Never
2. Always2. Always
3. PreserveNewest3. PreserveNewest

EmbeddedResourceEmbeddedResource

생성된 어셈블리에 포함될 리소스를 나타냅니다.Represents resources to be embedded in the generated assembly.

항목 이름Item Name 설명Description
DependentUponDependentUpon 선택적 문자열입니다.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.
LastGenOutputLastGenOutput 필수 문자열입니다.Required string. 이 항목에서 실행된 모든 파일 생성기가 만든 파일의 이름입니다.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace 필수 문자열입니다.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.
CopyToOutputDirectoryCopyToOutputDirectory 선택적 문자열입니다.Optional string. 출력 디렉터리에 파일을 복사할지 여부를 결정합니다.Determines whether to copy the file to the output directory. 값:Values are:

1. Never1. Never
2. Always2. Always
3. PreserveNewest3. PreserveNewest
LogicalNameLogicalName 필수 문자열입니다.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 Name 설명Description
DependentUponDependentUpon 선택적 문자열입니다.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.
LastGenOutputLastGenOutput 필수 문자열입니다.Required string. 이 항목에서 실행된 모든 파일 생성기가 만든 파일의 이름입니다.The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace 필수 문자열입니다.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.
PublishStatePublishState 필수 문자열입니다.Required string. 콘텐츠의 게시 상태로 다음 중 하나입니다.The publish state of the content, either:

- 기본값- Default
- 포함됨- Included
- 제외됨- Excluded
- DataFile- DataFile
- 필수 조건- Prerequisite
IsAssemblyIsAssembly 선택적 부울입니다.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.
CopyToOutputDirectoryCopyToOutputDirectory 선택적 문자열입니다.Optional string. 출력 디렉터리에 파일을 복사할지 여부를 결정합니다.Determines whether to copy the file to the output directory. 값:Values are:

1. Never1. Never
2. Always2. Always
3. PreserveNewest3. PreserveNewest

없음None

빌드 프로세스에서 역할이 없는 파일을 나타냅니다.Represents files that should have no role in the build process.

항목 이름Item Name 설명Description
DependentUponDependentUpon 선택적 문자열입니다.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.
LastGenOutputLastGenOutput 필수 문자열입니다.Required string. 이 항목에서 실행된 모든 파일 생성기가 만든 파일의 이름입니다.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace 필수 문자열입니다.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.
CopyToOutputDirectoryCopyToOutputDirectory 선택적 문자열입니다.Optional string. 출력 디렉터리에 파일을 복사할지 여부를 결정합니다.Determines whether to copy the file to the output directory. 값:Values are:

1. Never1. Never
2. Always2. Always
3. PreserveNewest3. PreserveNewest

BaseApplicationManifestBaseApplicationManifest

빌드에 대한 기본 응용 프로그램 매니페스트를 나타내며 ClickOnceClickOnce 배포 보안 정보를 포함합니다.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

가져올 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

일반적인 MSBuild 프로젝트 속성Common MSBuild Project Properties