Take Advantage of XML Comments: Listing 1

<?xml version="1.0" encoding="utf-8" ?>
<XMLDocCommentSchema>

<CodeElement type="Class">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Declare">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Delegate">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
	<CompletionList>
	    <include file="" path="" />
	    <param name="" />
	    <permission cref="" />
	    <remarks />
	    <returns />
	    <summary />
	</CompletionList>
</CodeElement>

<CodeElement type="Enum">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Event">
    <Template>
		<summary />
		<param />
		<remarks />
		</Template>
	<CompletionList>
	    <include file="" path="" />
	    <param name="" />
	    <permission cref="" />
	    <remarks />
	    <summary />
	</CompletionList>
</CodeElement>

<CodeElement type="Field">
    <Template>
        <summary />
		<remarks />
	</Template>
	    <CompletionList>
	    <include file="" path="" />
	    <permission cref="" />
	    <remarks />
	    <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Function">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
    </Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Interface">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Module">
    <Template>
        <summary />
        <remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Operator">
    <Template>
		<summary />
		<param />
		<returns />
		<remarks />
	</Template>
    <CompletionList>
		<exception cref="" />
		<include file="" path="" />
		<param name="" />
		<permission cref="" />
		<remarks />
		<returns />
		<summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Property">
    <Template>
        <summary />
        <param />
        <value />
        <remarks />
    </Template>
    <CompletionList>
        <exception cref="" />
        <include file="" path="" />
        <param name="" />
        <permission cref="" />
        <remarks />
        <summary />
        <value />
    </CompletionList>
</CodeElement>

<CodeElement type="Structure">
    <Template>
		<summary />
		<remarks />
    </Template>
    <CompletionList>
        <include file="" path="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

<CodeElement type="Sub">
    <Template>
        <summary />
        <param />
        <remarks />
    </Template>
    <CompletionList>
        <exception cref="" />
        <include file="" path="" />
        <param name="" />
        <permission cref="" />
        <remarks />
        <summary />
    </CompletionList>
</CodeElement>

  <ChildCompletionList> 
    <c/> 
    <code/> 
    <example/> 
    <list type=""> 
		<description/>
		<item>
			<description/>
			<term/>
		</item>
		<listheader> 
			<term/> 
			<description/> 
		</listheader> 
		<term/> 
    </list> 
    <para/> 
    <paramref name=""/> 
    <see cref=""/> 
    <seealso cref=""/> 
  </ChildCompletionList>

</XMLDocCommentSchema>

About the Author

Joe Kunk is a Microsoft MVP in Visual Basic, three-time president of the Greater Lansing User Group for .NET, and developer for Dart Container Corporation of Mason, Michigan. He's been developing software for over 30 years and has worked in the education, government, financial and manufacturing industries. Kunk's co-authored the book "Professional DevExpress ASP.NET Controls" (Wrox Programmer to Programmer, 2009). He can be reached via email at [email protected].

comments powered by Disqus

Featured

  • Low-Coding in the Age of AI: Dataverse Embraces Copilot, Claude and Cursor

    Microsoft is extending Dataverse into coding-agent marketplaces while expanding its MCP tools, certification program and governance controls.

  • Visual Studio Takes Aim at Copilot Billing Shock

    Beyond Copilot usage visibility, the June update delivers several other enhancements centered on AI-assisted development, security and quality-of-life improvements. Here's a quick rundown of the remaining additions announced by Microsoft.

  • Claude AI Gets Yet Another Boost in VS Code 1.128

    The July 8, 2026, Visual Studio Code update expands agent workflows, chat attachments, browser-tab controls, OS-level shortcuts and enterprise telemetry management.

  • TypeScript 7 Arrives to Rock VS Code with Go-Powered Speed

    Microsoft says TypeScript 7, announced July 8, brings native Go performance to VS Code, Visual Studio and other editors.

Subscribe on YouTube