<include> (Visual Basic)

Fait référence à un autre fichier qui décrit les types et membres dans votre code source.

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

Paramètres

• filename
  Obligatoire. Nom du fichier contenant la documentation. Le nom du fichier peut être précisé par un chemin. Mettez filename entre guillemets doubles (" ").

• tagpath
  Obligatoire. Chemin d'accès des balises dans filename qui permet d'accéder au name de la balise. Mettez le chemin d'accès entre guillemets doubles (" ").

• name
  Obligatoire. Spécificateur de nom dans la balise qui précède les commentaires. Name aura un id.

• id
  Obligatoire. ID de la balise qui précède les commentaires. Mettez l'ID entre guillemets simples (' ').

Notes

Utilisez la balise <include> pour faire référence à des commentaires situés dans un autre fichier qui décrivent les types et membres dans votre code source. Cette solution remplace celle consistant à placer des commentaires de documentation directement dans votre fichier de code source.

La balise <include> utilise la recommandation du W3C intitulée XML Path Language (XPath) Version 1.0. Plus d'informations sur les moyens de personnaliser votre utilisation de <include> sont disponibles à la page http://www.w3.org/TR/xpath.

Exemple

Cet exemple utilise la balise <include> pour importer des commentaires de documentation membre d'un fichier nommé 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

Le format du commentFile.xml est le suivant :

<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>

Voir aussi

Référence

Balises XML recommandées pour les commentaires de documentation (Visual Basic)