2
XML 주석의 출현 이전에 만들어진 많은 .Net 코드를 업그레이드하는 중입니다.일반 댓글에서 XML 주석 생성
이 코드는 직접 해당 코드의 멤버 이상 중 하나입니다 의견을 많이 포함
' This property returns true if ...
Public ReadOnly Property ReturnTrueIf As Boolean
또는 내가 모래처럼 자동 문서 컴파일러에 의해 사용되었다 생각 "오래된 학교"형식
:'===================================================
' Class Description:
' Description of this class
'
' Remarks:
' Some remarks about this class.
'
Public Class SomeClass
이러한 주석에 캡슐화 된 많은 중요한 정보가 XML 주석을 통해 공개하려고합니다.
그러나 XML 주석 템플릿 (멤버 바로 위에 '' '입력)을 먼저 삽입 한 다음 이전 주석 앞에 XML 주석 표시기 (' '')를 추가하여 이러한 주석을 수동으로 변환 할 수있었습니다. 수동으로 새 XML 블록으로 이동합니다. 이것은 분명히 비효율적입니다. 우리는 픽업 메소드 매개 변수를 원하기 때문에
불행하게도 우리는 단지에 구운 알려진 애드이나 기능이 있는가 등의 값을 반환,
을 매크로에 포함 된 XML 주석 템플릿 코드의 표준 블록을 사용할 수 없습니다 우리가 바라 보는 VS2012?
_ XML의 출현에 대한 코멘트 _ 호기심에서, 언제 소개 되었습니까? 나는 그들이 항상 거기에 있다고 생각했다. –
2000 년대 초반 (.net 1.0/1, VS2002/3). VS2005까지 VB.Net에는 정식 XML 주석이 도입되지 않았습니다. –