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

  • VS Code Keeps Eye on Costs in v1.126 Update

    Visual Studio Code 1.126 adds session-level Copilot cost information, continuing Microsoft's recent focus on helping developers monitor and manage usage-based GitHub Copilot billing.

  • Open VSX 1.0.0 Puts Focus on Open Extension Registry for VS Code Ecosystem

    Eclipse Open VSX has reached 1.0.0, highlighting its role as a vendor-neutral registry for VS Code-compatible extensions.

  • Infragistics Puts MCP Toolchain at Center of Ultimate 26.1

    Infragistics Ultimate 26.1 introduces the Ignite UI Enterprise MCP toolchain for AI-assisted app development across Angular, React, Web Components and Blazor.

  • VS Code 1.125 Adds Copilot Spend Meter After Billing Shock

    VS Code 1.125 adds in-editor visibility into additional Copilot budget usage as GitHub's AI-credit billing model continues to draw developer scrutiny.

Subscribe on YouTube