<포함>(Visual Basic)

소스 코드의 형식과 멤버를 설명하는 다른 파일을 참조하세요.

구문

<include file="filename" path="tagpath[@name='id']" />  

매개 변수

filename
필수입니다. 문서가 포함된 파일의 이름입니다. 경로를 사용하여 파일 이름을 정규화할 수 있습니다. filename을 큰따옴표(" ")로 묶습니다.

tagpath
필수입니다. filename의 태그 경로로, name 태그에 연결됩니다. 경로를 큰따옴표(" ")로 묶습니다.

name
필수입니다. 주석 앞에 있는 태그의 이름 지정자입니다. Name에는 id가 있습니다.

id
필수입니다. 주석 앞에 오는 태그의 ID입니다. ID를 작은따옴표(' ')로 묶습니다.

설명

소스 코드의 형식과 멤버를 설명하는 다른 파일의 주석을 참조하려면 <include> 태그를 사용합니다. 소스 코드 파일에 직접 문서 주석을 포함하는 대신 사용되는 대안입니다.

<include> 태그는 W3C XPath(XML 경로 언어) 버전 1.0 권장 사항을 사용합니다. <include> 사용을 사용자 지정하는 방법에 대한 자세한 내용은 https://www.w3.org/TR/xpath를 참조하세요.

예시

이 예에서는 <include> 태그를 사용하여 commentFile.xml이라는 파일에서 멤버 설명서 설명을 가져옵니다.

''' <include file="commentFile.xml"
''' path="Docs/Members[@name='Open']/*" />
Public Sub Open(ByVal filename As String)
    ' Code goes here.
End Sub
''' <include file="commentFile.xml"
''' path="Docs/Members[@name='Close']/*" />
Public Sub Close(ByVal filename As String)
    ' Code goes here.
End Sub

commentFile.xml의 형식은 다음과 같습니다.

<Docs>  
<Members name="Open">  
<summary>Opens a file.</summary>  
<param name="filename">File name to open.</param>  
</Members>  
<Members name="Close">  
<summary>Closes a file.</summary>  
<param name="filename">File name to close.</param>  
</Members>  
</Docs>  

참고 항목

• XML 주석 태그