UML 모델의 .NET 요소에 XML 주석 추가

특성 보기의 두 위치(문서 페이지나 XML 주석 페이지)에서 XML 주석을 추가할 수 있습니다.
시작하기 전에

UML에서 C#으로 변환 또는 .Net WCF 프로파일을 모델에 적용해야 합니다.

환경 설정 창에서 모델링 > 기타를 펼치고 다이어그램 및 문서에서 리치 텍스트 표시 선택란에서 선택 표시가 지워져 있는지 확인하십시오.

이 태스크 정보
UML에서 C#으로 변환을 실행할 때 모델의 XML 주석은 소스 코드에서 XML 태그로 생성되고, 참조하는 코드 블록 바로 앞에 있는 특수 주석 필드에서는 텍스트로 생성됩니다. C#에서 UML로 변환을 실행할 때 소스 코드의 XML 태그는 특성 보기의 문서XML 주석 페이지에서 주석으로 생성됩니다.
주: XML 주석이 프리프로세서 지시문 이전에 코드 소스 파일에 표시되면 XML 주석이 모델에 생성되지 않습니다. 이 영역은 사용자 코드 섹션으로 해석되기 때문입니다.

XML 주석 페이지를 사용하여 XML 주석을 .NET 요소에 추가하려면 다음을 수행하십시오.

  1. XML 주석을 지원하는 .NET 요소가 포함된 모델을 작성하십시오.
  2. 모델에서 .NET 요소를 선택하십시오.
  3. XML 주석 페이지 편집기에 커서를 위치시킨 후 단추를 클릭하여 해당되는 XML 태그의 여고 닫는 태그를 추가하십시오. XML 태그와 연관되는 속성도 작성됩니다.
다음에 수행할 작업

C#에서, XML 태그가 참조하는 코드 블록 바로 앞에 있는 소스 코드의 특수 주석 필드에 XML 태그를 포함시켜서 코드에 대한 문서를 작성할 수 있습니다.

XML 주석을 포함하는 코드가 /doc 옵션으로 컴파일될 때 컴파일러는 소스 코드의 모든 XML 태그를 검색하고 XML 문서 파일을 작성합니다. 컴파일러에서 생성된 파일을 기반으로 최종 문서를 작성하려면 사용자 정의 도구를 작성할 수 있습니다.


피드백