Linq to SQL 的 C# XML 文档
C# XML documentation of Linq to SQL
如何记录使用 LINQ to SQL DBML 自动生成的 classes、属性和函数？
我设法通过在另一个文件中使用 <summary> 定义相同的部分 class 来为数据上下文 class 提供文档，因此如果刷新 DBML
/// <summary>
/// Linq to SQL datacontext
/// </summary>
public partial class LinqDBDataContext {
}
这适用于 table 映射 class，但缺点是必须为 added/removed table 手动维护单独的 class。
另一件事..我在存储过程中有类似注释的文档（作者、日期和描述），不应该也作为函数的文档提取到代码文件中吗？
-- =============================================
-- Author: <Katia Aleid>
-- Create date: <2015-04-01>
-- Description: <Performs search for the users>
-- =============================================
ALTER PROCEDURE [dbo].[SearchUsers] ....
是否接受table排除 DBML 形式的 C# 文档并使用单独的数据库文档？
注释在 存储过程中不太可能被 SqlMetal 解析； 一推，它可以访问 MS_Description 扩展元数据，如果您分配了一些 - 但是，我不会 期望 它要做到这一点。查看 dbml 元数据，没有明显的地方可以存储或编辑附加评论，所以坦率地说，我怀疑这里的答案是：你没有。您不应该编辑 *.designer.cs，因为它可以随机重新生成。
如何记录使用 LINQ to SQL DBML 自动生成的 classes、属性和函数？
我设法通过在另一个文件中使用 <summary> 定义相同的部分 class 来为数据上下文 class 提供文档，因此如果刷新 DBML
/// <summary>
/// Linq to SQL datacontext
/// </summary>
public partial class LinqDBDataContext {
}
这适用于 table 映射 class，但缺点是必须为 added/removed table 手动维护单独的 class。
另一件事..我在存储过程中有类似注释的文档（作者、日期和描述），不应该也作为函数的文档提取到代码文件中吗？
-- =============================================
-- Author: <Katia Aleid>
-- Create date: <2015-04-01>
-- Description: <Performs search for the users>
-- =============================================
ALTER PROCEDURE [dbo].[SearchUsers] ....
是否接受table排除 DBML 形式的 C# 文档并使用单独的数据库文档？
注释在 存储过程中不太可能被 SqlMetal 解析； 一推，它可以访问 MS_Description 扩展元数据，如果您分配了一些 - 但是，我不会 期望 它要做到这一点。查看 dbml 元数据，没有明显的地方可以存储或编辑附加评论，所以坦率地说，我怀疑这里的答案是：你没有。您不应该编辑 *.designer.cs，因为它可以随机重新生成。