C#.NET WinForms使用NpgsqlFactory时单引号传递异常问题

问题根源 #

PostgreSQL中用两个单引号（''）表示转义后的单个单引号，或空字符串；但在C#字符串中直接拼接SQL时，若转义方式错误，会破坏SQL语法结构，引发解析失败，出现42P01表不存在或空字符串类错误。

正确解决方案 #

1. 直接构造SQL时的单引号转义 #

• 需求：拼接空字符串（对应pgAdmin中的CONCOLUMN_NAMECAT(XY.PropertyNameHere, '')）
  C#中双引号包裹的字符串里，单引号无需额外转义，直接写两个单引号即可：

  // 逐字字符串写法（避免转义干扰）
  string sql = @"STRING_AGG(CONCAT(XY.PropertyNameHere, ''), ', ' ORDER BY XY.PropertyNameHere) AS TableNameHere";
  
  // 常规字符串写法效果一致
  string sql = "STRING_AGG(CONCAT(XY.PropertyNameHere, ''), ', ' ORDER BY XY.PropertyNameHere) AS TableNameHere";
  

• 需求：给字段值添加单引号（比如生成'val1', 'val2'格式的聚合结果）
  需要在C#字符串中写四个单引号（对应PostgreSQL解析后的两个单引号，即一个转义后的单引号）：

  string sql = @"STRING_AGG(CONCAT('''', XY.PropertyNameHere, ''''), ', ' ORDER BY XY.PropertyNameHere) AS TableNameHere";
  

  这段代码传递给PostgreSQL后，会被解析为CONCAT('''', XY.PropertyNameHere, '''')，最终实现给每个字段值前后添加单引号的效果。

2. 动态标识符处理（推荐） #

如果SQL中包含动态表名、字段名，直接拼接易引发语法错误，使用NpgsqlCommand.QuoteIdentifier()方法转义标识符：

var tableAlias = "XY";
var propertyName = "PropertyNameHere";
var resultAlias = "TableNameHere";

using var cmd = new NpgsqlCommand();
// 转义动态标识符，避免语法错误
var quotedProperty = cmd.QuoteIdentifier($"{tableAlias}.{propertyName}");
var quotedResultAlias = cmd.QuoteIdentifier(resultAlias);

string sql = $"STRING_AGG(CONCAT({quotedProperty}, ''), ', ' ORDER BY {quotedProperty}) AS {quotedResultAlias}";
cmd.CommandText = sql;
// 后续执行逻辑...

3. 错误案例解析 #

• 使用", "作为分隔符会导致聚合分隔符为空，触发String has a length of zero错误。
• 使用', '直接拼接会破坏SQL结构，PostgreSQL将部分字符串误解析为表名，引发42P01表不存在错误。

内容的提问来源于stack exchange，提问作者Daniel