<include> (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 Path Language) 버전 1.0 권장 사항을 사용합니다. 사용을 사용자 지정하는 방법에 대한 자세한 내용은 다음을 참조https://www.w3.org/TR/xpath하세요<include>.

예시

이 예제에서는 태그를 <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 주석 태그