StyleCop規則翻譯

來源:http://bradywang0416.blogspot.tw/2015/03/stylecop.html

來源來自於: http://bradywang0416.blogspot.tw/2015/03/stylecop.html

所有規則的翻譯(基於版本4.7.44.0):


1、SA1600:ElementsMustBeDocumented元素必須添加注釋
2、SA1601: PartialElementsMustBeDocumented   Partial修飾的成員必須添加注釋
3、SA1602:EnumerationItemsMustBeDocumented 枚舉必須添加注釋
4、SA1603: DocumentationMustContainValidXml  注釋必須合法(注釋中的關鍵字不能有錯誤)
5、SA1604: ElementDocumentationMustHaveSummary 元素注釋必須包含Summary關鍵字
6、SA1605:PartialElementDocumentationMustHaveSummary   Partial修飾的成員注釋必須包含Summary關鍵字
7、SA1606:ElementDocumentationMustHaveSummaryText   Summary節點內部必須添加文本
8、SA1607:PartialElementDocumentationMustHaveSummaryText  Partial修飾的成員注釋Summary節點內部必須添加文本
9、SA1608:ElementDocumentationMustNotHaveDefaultSummary  Summary注釋不能使用編譯器自帶的注釋文本
10、SA1609:PropertyDocumentationMustHaveValue   屬性的注釋中必須包含<Value>節點
11、SA1610:PropertyDocumentationMustHaveValueText  屬性的注釋<Value>節點必須包含文本值
12、SA1611:ElementParametersMustBeDocumented   参數必須注釋
13、SA1612:ElementParameterDocumentationMustMatchElementParameters  参數的個數必須與注釋裏的個數一致
14、SA1613:ElementParameterDocumentationMustDeclareParameterName 参數的注釋裏必須有参數的名稱
15、SA1614:ElementParameterDocumentationMustHaveText    参數注釋節點裏不能空着
16、SA1615:ElementReturnValueMustBeDocumented  返回值必須添加注釋
17、SA1616:ElementReturnValueDocumentationMustHaveText  返回值注釋的節點內必須有文本值
18、SA1617:VoidReturnValueMustNotBeDocumented 空返回值一定不能有返回值注釋
19、SA1618:GenericTypeParametersMustBeDocumented 生成的類型(泛型)参數必須有注釋
20、SA1619:GenericTypeParametersMustBeDocumentedPartialClass  SA1618情況如果有Partial類存在都要有注釋
21、SA1620:GenericTypeParameterDocumentationMustMatchTypeParameters 注釋與泛型必須能匹配上
22、SA1621:GenericTypeParameterDocumentationMustDeclareParameterName 泛型的注釋必須包含泛型定義是的關鍵字(如’T’)
23、SA1622:GenericTypeParameterDocumentationMustHaveText  泛型的注釋節點中必須包含文本值
24、SA1623:PropertySummaryDocumentationMustMatchAccessors  屬性的注釋必須與屬性的讀寫權限匹配,private類型的屬性不能出現在注釋裏
25、SA1624:PropertySummaryDocumentationMustOmitSetAccessorWithRestrictedAccess 屬性的注釋裏必須忽略protected關鍵字,當成public類型當注釋
26、SA1625:ElementDocumentationMustNotBeCopiedAndPasted  各個参數的注解不能完全相同(避免copy、post行为)
27、SA1626:SingleLineCommentsMustNotUseDocumentationStyleSlashes  單行注釋不能采取三個斜線的注釋方式,斜線的個數必須是二的倍數
28、SA1627:DocumentationTextMustNotBeEmpty   注釋節點內部不能为空(必須有文本值)
29、SA1628:DocumentationTextMustBeginWithACapitalLetter  注釋節點內部的文本必須以大寫字母開頭
30、SA1629:DocumentationTextMustEndWithAPeriod  注釋節點內部的文本必須英文的句號結束
31、SA1630:DocumentationTextMustContainWhitespace  注釋節點內部的文本必須包含空格
32、SA1631:DocumentationMustMeetCharacterPercentage 注釋節點內部的文本中不能包含過多的字符(舉例:包含’---------------------------------------’是不允許的)
33、SA1632:DocumentationTextMustMeetMinimumCharacterLength  已經作廢的規則,不允許有太短的字符串(如’A name’ 中的A字母)
34、SA1633:FileMustHaveHeader   代碼文件頭部必須有說明,一般放置版權信息
35、SA1634:FileHeaderMustShowCopyright   代碼文件頭部注解中必須包含版權關鍵字
36、SA1635:FileHeaderMustHaveCopyrightText代碼文件頭部注解中必須包含版權信息內同
37、SA1636:FileHeaderCopyrightTextMustMatch  代碼文件頭部注解中版權信息必須與設置畫面設置的內容相匹配,在”style seting”畫面的” Company Information tab”進行設置
38、SA1637:FileHeaderMustContainFileName  代碼文件頭部注解中必須包含文件名稱
39、SA1638:FileHeaderFileNameDocumentationMustMatchFileName  代碼文件頭部注解中必須包含文件名稱必須與實際的名稱匹配
40、SA1639:FileHeaderMustHaveSummary  代碼文件頭部注解中必須包含Summary節點
41、SA1640:FileHeaderMustHaveValidCompanyText 代碼文件頭部注解中版權信息必須含有合理的公司名字
42、SA1641:FileHeaderCompanyNameTextMustMatch  代碼文件頭部注解中的公司名字必須與設置畫面設置的內容相匹配,在”style seting”畫面的” Company Information tab”進行設置
43、SA1642:ConstructorSummaryDocumentationMustBeginWithStandardText  構造函數注釋標准:“Initializes a new instance of the <see cref="Customer{T}"/> class.”
44、SA1643:DestructorSummaryDocumentationMustBeginWithStandardText  析構函數注釋標准:“Finalizes an instance of the <see cref="Customer"/> class.”
45、SA1644:DocumentationHeadersMustNotContainBlankLines   注釋中不能出現空白行
46、SA1645:IncludedDocumentationFileDoesNotExist   如果注釋中包含文件,要確定這個文件存在,舉例:“       /// <include file="IncludedDocumentation.xml" path="root/EnabledMethodDocs" />” 這一項過於复雜不建議用,但是如果將來想規範化相同共性東西的注釋的時候倒是可以考慮引入。
47、SA1646:IncludedDocumentationXPathDoesNotExist  如果注釋中包含文件,路徑不存在。
48、SA1647:IncludeNodeDoesNotContainValidFileAndPath  如果注釋中包含文件 文件與路徑都要合法
49、SA1648:InheritDocMustBeUsedWithInheritingClass   這項不明白是什麼意思,還請知道的分享给我,謝謝。
50、SA1649:FileHeaderFileNameDocumentationMustMatchTypeName  文件頭注釋必須匹配類型
51、SA1650:ElementDocumentationMustBeSpelledCorrectly 注釋不能有拼寫錯誤(對中文支持不好,不建議使用該項)
 

布局規則


1、 SA1500:CurlyBracketsForMultiLineStatementsMustNotShareLine  花括號不能再同一行。
標准格式:  public StRsvrRFun()
         {
          }
2、SA1501:StatementMustNotBeOnASingleLine   語句不能共享一行
3、SA1502:ElementMustNotBeOnASingleLine   語句不能共享一行
4、SA1503:CurlyBracketsMustNotBeOmitted  花括弧即使在單行代碼的情況下也不能省略。
5、SA1504:AllAccessorsMustBeSingleLineOrMultiLine  讀寫屬性,要麼在同一行業要麼在分多行寫,不可規則不統一(個人建議分多行寫)。
6、SA1505:OpeningCurlyBracketsMustNotBeFollowedByBlankLine 開始的花括弧後面不能有空白行
7、SA1506:ElementDocumentationHeadersMustNotBeFollowedByBlankLine 元素頭部注釋跟元素之間不能有空白行
8、SA1507:CodeMustNotContainMultipleBlankLinesInARow 不允許有多行空白行緊挨着(個人建議寫一個空白行即可)
9、SA1508:ClosingCurlyBracketsMustNotBePrecededByBlankLine 結尾的花括弧不能再一個空白行之前
10、SA1509:OpeningCurlyBracketsMustNotBePrecededByBlankLine  開始的花括弧不能再一個空白行之前
11、SA1510:ChainedStatementBlocksMustNotBePrecededByBlankLine 相連的語句之間不能有空白行,如try語句與catch語句之間不能有空白行
12、SA1511:WhileDoFooterMustNotBePrecededByBlankLine  與SA1510相同,Do語句與While語句之間不能有空白行
13、SA1512:SingleLineCommentsMustNotBeFollowedByBlankLine 單行注釋不能後跟空白行
14、SA1513:ClosingCurlyBracketMustBeFollowedByBlankLine 結束花括弧之後必須有一個空白行
15、SA1514:ElementDocumentationHeaderMustBePrecededByBlankLine 頭部注解之前必須有一個空白行
16、SA1515:SingleLineCommentMustBePrecededByBlankLine 單行注釋之前要有一個空白行,還一種方法是不加空白行而用四個斜線注釋”////”,建議採取第一種方法
17、SA1516:ElementsMustBeSeparatedByBlankLine 鄰近的元素之間要有一個空白行
18、SA1517:CodeMustNotContainBlankLinesAtStartOfFile 代碼文件頭部字符之前不能出現空白行
19、SA1518:CodeMustNotContainBlankLinesAtEndOfFile代碼文件尾部字符之後不能出現空白行
 

可維護規則


1、 SA1119:StatementMustNotUseUnnecessaryParenthesis  語句中不可以出現多餘的括弧,無意義的括弧增加了代碼的可讀性
2、 SA1400:AccessModifierMustBeDeclared  必須定義訪問修飾符
3、 SA1401:FieldsMustBePrivate  字段必須定義为私有的
4、 SA1402:FileMayOnlyContainASingleClass 一個CS文件裏只定義一個類
5、 SA1403:FileMayOnlyContainASingleNamespace  一個CS文件只包含一個命名空間
6、 SA1404:CodeAnalysisSuppressionMustHaveJustification   Suppression特性(取消報告特定的靜態分析工具規則沖突,允許一個代碼項目上應用多個取消報告設置)必須要有合理理由
7、 SA1405:DebugAssertMustProvideMessageText 参見代碼:“Debug.Assert(value != true, "The value must always be true.");”
8、 SA1406:DebugFailMustProvideMessageText   参見代碼:“Debug.Fail("The code should never reach this point.");”
9、 SA1407:ArithmeticExpressionsMustDeclarePrecedence 算數表達式必須用明確的標明其優先級(此條與SA1119沖突)
10、 SA1408:ConditionalExpressionsMustDeclarePrecedence 條件表達式必須明確的標明其優先級(此條與SA1119沖突) 舉例:“if (x || (y && z && a) || b)”
11、 SA1409:RemoveUnnecessaryCode  移除無用的代碼
12、 SA1410:RemoveDelegateParenthesisWhenPossible  調用一個c#匿名方法不包含任何方法参數,必須要包括一個空括號(本人不建議使用匿名方法、匿名委托的語法,具體原因後續做分享)
13、 SA1411:AttributeConstructorMustNotUseUnnecessaryParenthesis 特性構造函數如果是空参的形式,不要包括那個空括號
 

命名規則


1、 SA1300:ElementMustBeginWithUpperCaseLetter  首字母必須大寫(個人理解應該是字段以外的東西)
2、 SA1301: ElementMustBeginWithLowerCaseLetter  不會出現的情況
3、 SA1302:InterfaceNamesMustBeginWithI  接口必須以“I”字母開頭
4、 SA1303:ConstFieldNamesMustBeginWithUpperCaseLetter Const常量首字母大寫
5、 SA1304:NonPrivateReadonlyFieldsMustBeginWithUpperCaseLetter 非私有非制度的字段必須首字母大寫
6、 SA1305:FieldNamesMustNotUseHungarianNotation 除了列表外的字符不可以出現匈牙利命名規則,在”Style Setting”裏的” Hungarian”Tab裏設置
7、 SA1306:FieldNamesMustBeginWithLowerCaseLetter 字段名必須首字母小寫
8、 SA1307:AccessibleFieldsMustBeginWithUpperCaseLetter public或者internal字段首字母大寫
9、 SA1308:VariableNamesMustNotBePrefixed  變量名不能有前綴
10、 SA1309:FieldNamesMustNotBeginWithUnderscore  字段名不能以下滑線開頭
11、 SA1310:FieldNamesMustNotContainUnderscore   字段名不能包括下滑線
12、 SA1311:StaticReadonlyFieldsMustBeginWithUpperCaseLetter static與readonly字段首字母大寫
 

排序規則


1、SA1200:UsingDirectivesMustBePlacedWithinNamespace   using部分必須在Namespace內部(個人不建議用這個規則)
2、SA1201:ElementsMustAppearInTheCorrectOrder 所有的元素必須出現在正確的位置上(個人不建議使用該規則,用region把一個類文件裏的元素分好組即可,字段、屬性、對外公布的接口、私有方法等組)
3、SA1202:ElementsMustBeOrderedByAccess  元素的修飾符有一個固定的順序(個人不建議使用該規則,用region把一個類文件裏的元素分好組即可,字段、屬性、對外公布的接口、私有方法等組)
4、SA1203:ConstantsMustAppearBeforeFields  常量字段擺放在其它字段之上
5、SA1204:StaticElementsMustAppearBeforeInstanceElements Static  元素擺放在前面
6、SA1205:PartialElementsMustDeclareAccess Partial修飾的元素必須聲明讀寫權限
7、SA1206:DeclarationKeywordsMustFollowOrder 舉例:
keywords must appear in the following order:
Access modifiers
static
All other keywords
8、SA1207:ProtectedMustComeBeforeInternal   Protected在Internal之前
9、SA1208:SystemUsingDirectivesMustBePlacedBeforeOtherUsingDirectives  系統級的引用在其他引用之前(格式化代碼就會自動按照這個規則編排using部分)
10、SA1209:UsingAliasDirectivesMustBePlacedAfterOtherUsingDirectives  using部分起別名的在最後排布
11、SA1210:UsingDirectivesMustBeOrderedAlphabeticallyByNamespace  using部分按照字母順序編排
12、SA1211:UsingAliasDirectivesMustBeOrderedAlphabeticallyByAliasName 別名的按照別名的字母編排
13、SA1212:PropertyAccessorsMustFollowOrder  屬性按照先get在set
14、SA1213:EventAccessorsMustFollowOrder  時間先remove在add
15、SA1214:StaticReadonlyElementsMustAppearBeforeStaticNonReadonlyElements  StaticReadonly元素在StaticNonReadonly元素之前
16、SA1215:InstanceReadonlyElementsMustAppearBeforeInstanceNonReadonlyElements
一個readonly 實例元素要在一個非readonly 實例元素
 

可讀性規則


1、 SA1100:DoNotPrefixCallsWithBaseUnlessLocalImplementationExists
change the ‘base.’ prefix to ‘this.’.
2、 SA1101:PrefixLocalCallsWithThis  ‘this.’前綴不能省略
3、 SA1102:QueryClauseMustFollowPreviousClause   linq語句要麼同一行,要麼關鍵字分布在多行,關鍵字對齊
4、 SA1103:QueryClausesMustBeOnSeparateLinesOrAllOnOneLine 不是很理解
5、 SA1104:QueryClauseMustBeginOnNewLineWhenPreviousClauseSpansMultipleLines不是很理解
6、 SA1105:QueryClausesSpanningMultipleLinesMustBeginOnOwnLine不是很理解
7、 SA1106:CodeMustNotContainEmptyStatements  不允許有空白的聲明
8、 SA1107:CodeMustNotContainMultipleStatementsOnOneLine 同一行裏不允許出現多個聲明語句
9、 SA1108:BlockStatementsMustNotContainEmbeddedComments  非法用例:
if (x != y)
    // Make sure x does not equal y
    {
    }
10、 SA1109:BlockStatementsMustNotContainEmbeddedRegions  非法用例:
    if (x != y)
    #region
    {
    }
    #endregion
11、 SA1110:OpeningParenthesisMustBeOnDeclarationLine 方法開始的括弧要在聲明的那一行
12、 SA1111:ClosingParenthesisMustBeOnLineOfLastParameter  方法結束括弧與最後一個参數同行
13、 SA1112:ClosingParenthesisMustBeOnLineOfOpeningParenthesis  如果是空参的情況,開始於結束括弧在同一行
14、 SA1113:CommaMustBeOnSameLineAsPreviousParameter  逗號必須與前一個参數同行
15、 SA1114:ParameterListMustFollowDeclaration
確保参數列表與開始括號同行,或者另起一行 参數整體要在同一行
16、 SA1115:ParameterMustFollowComma 参數與参數之間不能隔空白行
17、 SA1116:SplitParametersMustStartOnLineAfterDeclaration  所有参數在同一行或者如下示例:
public string JoinName(
        string first,
        string last)
18、SA1117:ParametersMustBeOnSameLineOrSeparateLines   同上
19、SA1118:ParameterMustNotSpanMultipleLines 實際調用是参數要在同一行
20、SA1120:CommentsMustContainText  注釋必須節點內部必須有文本
21、SA1121:UseBuiltInTypeAlias  使用內嵌的類型別名,如下表:
 

Type Alias Type Fully Qualified Type
bool Boolean System.Boolean
byte Byte System.Byte
char Char System.Char
decimal Decimal System.Decimal
double Double System.Double
short Int16 System.Int16
int Int32 System.Int32
long Int64 System.Int64
object Object System.Object
sbyte SByte System.SByte
float Single System.Single
string String System.String
ushort UInt16 System.UInt16
uint UInt32 System.UInt32
ulong UInt64 System.UInt64


22、SA1122:UseStringEmptyForEmptyStrings 
示例代碼:“string s = string.Empty;”不能寫成” string s = ""; ”
23、SA1123:DoNotPlaceRegionsWithinElements  不使用region(個人較反對這條,個人傾向於用region規整類裏的元素)
24、SA1124:DoNotUseRegions  不使用region(個人較反對這條,個人傾向於用region規整類裏的元素)
25、SA1125:UseShorthandForNullableTypes  使用簡寫版的可空類型 如”int?”
26、SA1126:PrefixCallsCorrectly  調用類成員的時候要帶上“this”前綴
 

拼寫規則


1、 SA1000:KeywordsMustBeSpacedCorrectly  關鍵字不能拼寫錯誤
2、 SA1001:CommasMustBeSpacedCorrectly 逗號前面擺放一個空格
3、 SA1002:SemicolonsMustBeSpacedCorrectly  分號前面擺放一個空格
4、 SA1003:SymbolsMustBeSpacedCorrectly  操作符與元素之間不加空格
5、 SA1004:DocumentationLinesMustBeginWithSingleSpace “///”注釋的每一行以一個空格開頭
6、 SA1005:SingleLineCommentsMustBeginWithSingleSpace  單行注釋以一個空格開頭
7、 SA1006:PreprocessorKeywordsMustNotBePrecededBySpace  預處理關鍵字內部不允許出現空格 如“# if Debug”是不允許的
8、 SA1007:OperatorKeywordMustBeFollowedBySpace   操作必須要在一個空格之後
9、 SA1008:OpeningParenthesisMustBeSpacedCorrectly  開始括弧放置合理的空格
10、 SA1009:ClosingParenthesisMustBeSpacedCorrectly  結尾括弧放置合理的空格
11、 SA1010:OpeningSquareBracketsMustBeSpacedCorrectly 開始方括號放置合理的空格
12、 SA1011:ClosingSquareBracketsMustBeSpacedCorrectly   結束方括號放置合理的空格
13、 SA1012:OpeningCurlyBracketsMustBeSpacedCorrectly  開始花括號放置合理的空格
14、 SA1013:ClosingCurlyBracketsMustBeSpacedCorrectly 結束花括號放置合理的空格
15、 SA1014:OpeningGenericBracketsMustBeSpacedCorrectly 同上
16、 SA1015:ClosingGenericBracketsMustBeSpacedCorrectly  同上
17、 SA1016:OpeningAttributeBracketsMustBeSpacedCorrectly  特性開始括號同上
18、 SA1017:ClosingAttributeBracketsMustBeSpacedCorrectly  特性結尾括號同上
19、 SA1018:NullableTypeSymbolsMustNotBePrecededBySpace 空類型前不放置空格
20、 SA1019:MemberAccessSymbolsMustBeSpacedCorrectly  成員訪問關鍵字前後有空格
21、 SA1020:IncrementDecrementSymbolsMustBeSpacedCorrectly 自增、自減關鍵字要有空格
22、 SA1021:NegativeSignsMustBeSpacedCorrectly  負號要有空格
23、 SA1022:PositiveSignsMustBeSpacedCorrectly   正號要有空格
24、 SA1023:DereferenceAndAccessOfMustBeSpacedCorrectly
25、 SA1024:ColonsMustBeSpacedCorrectly  冒號運算符要有空格
26、 SA1025:CodeMustNotContainMultipleWhitespaceInARow  同一行不允許出現多個空格
27、 SA1026:CodeMustNotContainSpaceAfterNewKeywordInImplicitlyTypedArrayAllocation  new關鍵字之後不允許出現空格
28、 SA1027:TabsMustNotBeUsed  不用tab字符(個人不建議採用這條)