视觉工作室意味着什么“文件没有标题”构建警告

Question

我正在构建我的项目，但我的单元测试项目中的两个文件给出了一个构建警告“文件没有标题”。他们是不相关的，否则不起眼.cs文件。我用谷歌搜索了但结果却被淹没了 “SA1633：文件没有标题，标题Xml无效，或标题不是....”

这些警告没有错误代码，它们意味着什么？

Answer 1

违反了StyleCop代码分析。

这意味着C＃源文件缺少文件头。

文件头必须从文件的第一行开始，并且必须格式化为包含Xml的注释块，如下所示：

//-----------------------------------------------------------------------
// <copyright file="NameOfFile.cs" company="CompanyName">
//     Company copyright tag.
// </copyright>
//-----------------------------------------------------------------------

Answer 2

添加到标题：

// <auto-generated />

由工具完全自动生成的文件，不应由StyleCop进行检查或强制执行，可以包含“自动生成”标头，而不是标准文件标头。这将导致StyleCop忽略该文件。此类标头切勿置于手动编写的代码文件的顶部。