/doc(C# 컴파일러 옵션)
/doc 옵션을 사용하면 XML 파일에 문서 주석을 포함시킬 수 있습니다.
/doc:file
인수
- file
컴파일에 사용되는 소스 코드 파일에 주석을 표시하는 XML의 출력 파일입니다.
설명
소스 코드 파일에서 다음 항목 앞에 나오는 문서 주석을 처리하여 XML 파일에 추가할 수 있습니다.
Main을 포함하는 소스 코드 파일은 먼저 XML로 출력됩니다.
생성된 .xml 파일을 IntelliSense 기능과 함께 사용하려면, .xml 파일의 파일 이름을 지원하려는 어셈블리와 같도록 설정한 다음 해당 .xml 파일을 어셈블리와 같은 디렉터리에 넣습니다.따라서 Visual Studio 프로젝트에서 이 어셈블리가 참조되는 경우에는 해당 .xml 파일도 함께 찾습니다.자세한 내용은 코드 주석 제공을 참조하십시오.
/target:module을 사용하여 컴파일하지 않으면 file에는 컴파일 출력 파일의 어셈블리 매니페스트가 들어 있는 파일 이름이 지정된 <assembly></assembly> 태그가 포함됩니다.
[!참고]
/doc 옵션은 모든 입력 파일에 적용되며, 프로젝트 설정에 지정하면 프로젝트의 모든 파일에 적용됩니다.특정 파일 또는 코드 섹션에서 문서 주석과 관련된 경고를 비활성화하려면#pragma warning을 사용합니다.
코드 주석에서 문서를 생성하는 방법에 대한 자세한 내용은 문서 주석에 대한 권장 태그를 참조하십시오.
Visual Studio 개발 환경에서 이 컴파일러 옵션을 설정하려면
프로젝트의 속성 페이지를 엽니다.
빌드 탭을 클릭합니다.
XML 문서 파일 속성을 수정합니다.
이 컴파일러 옵션을 프로그래밍 방식으로 설정하는 방법은 DocumentationFile을 참조하십시오.