Dapper编写的SQL语句中省略号(...)的含义是什么？

问题场景 #

在阅读C#代码时遇到以下片段：

await connection.ExecuteAsync("CREATE TABLE #TempTable (Col1 NVARCHAR(20), Col2 NVARCHAR(20))", transaction: transaction);
await connection.BulkInsertAsync("INSERT INTO #TempTable VALUES (@Col1,@Col2) ...", transaction: transaction);

将这段SQL语句直接粘贴到SSMS执行时，会报错Incorrect syntax near '.'，但在代码中却能正常运行，想了解这个省略号的作用，以及是否可以安全移除。

解答 #

1. SSMS报错的原因 #

...不是SQL Server支持的合法语法，SQL Server无法识别这个符号，直接执行自然会报语法错误。

2. 代码中能运行的原因 #

这里的BulkInsertAsync不是原生ADO.NET方法，而是某个封装的批量插入方法（可能是自定义扩展方法或第三方库提供）。它不会直接把传入的SQL原封不动发给数据库，而是会对字符串做特殊处理：

• 要么这个...是代码里的占位符注释——写代码的人用它示意“这里省略了批量插入的多条VALUES子句逻辑”，实际运行的代码中...已经被动态生成的合法SQL片段替换；
• 要么是该方法约定用...作为批量插入标记，内部会自动把它替换成对应数量的参数占位符集合，实现批量插入多条数据。

3. 是否可以安全移除 #

• 如果只是代码里的占位符注释（仅用于示意）：真实运行的代码中没有这个...，移除后只要保证SQL语句本身合法（比如批量插入时要有完整的VALUES子句集合），就不会有问题；
• 如果是BulkInsertAsync方法要求的特殊标记：移除后方法无法正确生成批量插入逻辑，会导致运行报错。

建议先查看这个BulkInsertAsync方法的实现代码或相关文档，确认它对传入SQL的约定规则。

内容的提问来源于stack exchange，提问作者Benjamin U.