XML 설명서(Visual C++)
Visual C++에서 XML 설명서 파일에 처리되는 주석을 소스 코드에 추가할 수 있습니다. 그러면 코드의 클래스에 대한 문서를 만드는 프로세스에 이 파일을 입력할 수 있습니다.
Visual C++ 코드 파일에서 XML 문서 주석은 메서드 또는 형식 정의 바로 앞에 있어야 합니다. 이 주석은 다음 시나리오에서 IntelliSense QuickInfo 데이터 팁을 채우는 데 사용할 수 있습니다.
코드가 WINMD 파일을 사용하여 Windows 런타임 구성 요소로 컴파일되는 경우
소스 코드가 현재 프로젝트에 포함된 경우
형식 선언 및 구현이 동일한 헤더 파일에 있는 라이브러리에서
참고 항목
현재 릴리스에서는 템플릿 또는 템플릿 형식이 포함된 항목(예: 매개 변수를 템플릿으로 사용하는 함수)에서 코드 주석이 처리되지 않습니다. 이러한 주석을 추가하면 정의되지 않은 동작이 발생합니다.
설명서 주석이 있는 XML 파일을 만드는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.
| 추가 정보 | 참조 |
|---|---|
| 사용할 컴파일러 옵션 | /doc |
| 문서에서 일반적으로 사용되는 기능을 제공하는 데 사용할 수 있는 태그 | 문서 주석에 대한 권장 태그 |
| 컴파일러에서 코드의 구문을 식별하기 위해 생성하는 ID 문자열 | XML 파일 처리 |
| 문서 태그를 구분하는 방법 | Visual C++ 설명서 태그에 대한 구분 기호 |
| 하나 이상의 XDC 파일에서 XML 파일 생성 | XDCMake 참조 |
| Visual Studio 기능 영역과 관련된 XML에 대한 정보 링크 | Visual Studio의 XML |
문서 주석의 텍스트에 XML 특수 문자를 넣어야 하는 경우 XML 엔터티 또는 CDATA 섹션을 사용해야 합니다.