C# XML documentation of Linq to SQL

Question

如何记录使用 LINQ to SQL DBML 自动生成的类和属性与函数？

我设法通过在另一个文件中定义相同的分部类来为 datacontext 类提供文档 <summary> 这样如果 DBML 刷新，它就不会被删除

/// <summary>  
/// Linq to SQL datacontext  
/// </summary>  
public partial class LinqDBDataContext {  
}

这将适用于表映射类，但有一个缺点是必须手动维护添加/删除的表的单独类。

另一件事..我在存储过程中有类似注释的文档（作者、日期和描述），难道不应该作为函数的文档提取到代码文件中吗？

-- =============================================
-- Author:      <Katia Aleid>
-- Create date: <2015-04-01>
-- Description: <Performs search for the users>
-- =============================================
ALTER PROCEDURE [dbo].[SearchUsers] ....

是否可以排除 DBML 表单 C# 文档并改用单独的数据库文档？

Answer 1

SqlMetal 不太可能解析存储过程中的注释;在推送时，如果您分配了一些元数据，它可以访问MS_Description扩展元数据 - 但是，我不希望它这样做。查看 dbml 元数据，没有任何明显的存储或编辑其他注释的地方，所以坦率地说，我怀疑这里的答案是：你没有。你不应该编辑*.designer.cs，因为它可以随机重新生成。