SA1506

<title>SA1506: ElementDocumentationHeadersMustNotBeFollowedByBlankLine</title> <script src="script/helpstudio.js" type="text/javascript"></script> <script src="script/StandardText.js" type="text/jscript"></script>

<script type="text/jscript">WritePageTop(document.title);</script>

TypeName	ElementDocumentationHeadersMustNotBeFollowedByBlankLine
CheckId	SA1506
Category	Layout Rules

Cause

An element documentation header above a C# element is followed by a blank line.

Rule Description

To improve the readability of the code, StyleCop requires blank lines in certain situations, and prohibits blank lines in other situations. This results in a consistent visual pattern across the code, which can improve recognition and readability of unfamiliar code.

A violation of this rule occurs when the element documentation header above an element is followed by a blank line. For example:

/// <summary>

/// Gets a value indicating whether the control is enabled.

/// </summary>

public bool Enabled

{

get { return this.enabled; }

}

The code above would generate an instance of this violation, since the documentation header is followed by a blank line.

How to Fix Violations

To fix a violation of this rule, remove the blank line following the documentation header.

How to Suppress Violations

[SuppressMessage("StyleCop.CSharp.LayoutRules", "SA1506:ElementDocumentationHeadersMustNotBeFollowedByBlankLine", Justification = "Reviewed.")]