<paramref> (Visual Basic)
Formats a word as a parameter.
<paramref name="name"/>
Parameters
- name
The name of the parameter to refer to. Enclose the name in double quotation marks (" ").
Remarks
The <paramref>
tag gives you a way to indicate that a word is a parameter. The XML file can be processed to format this parameter in some distinct way.
Compile with /doc to process documentation comments to a file.
Example
This example uses the <paramref>
tag to refer to the id
parameter.
''' <param name="id">The ID of the record to update.</param>
''' <remarks>Updates the record <paramref name="id"/>.
''' <para>Use <see cref="DoesRecordExist"/> to verify that
''' the record exists before calling this method.</para>
''' </remarks>
Public Sub UpdateRecord(ByVal id As Integer)
' Code goes here.
End Sub
''' <param name="id">The ID of the record to check.</param>
''' <returns><c>True</c> if <paramref name="id"/> exists,
''' <c>False</c> otherwise.</returns>
''' <remarks><seealso cref="UpdateRecord"/></remarks>
Public Function DoesRecordExist(ByVal id As Integer) As Boolean
' Code goes here.
End Function
See Also
Reference
Recommended XML Tags for Documentation Comments (Visual Basic)