补充 object parms 注释

FreeSql/FreeSql.xml

@@ -932,7 +932,8 @@
         </member>
         <member name="M:FreeSql.IDelete`1.Where(System.String,System.Object)">
             <summary>
-            原生sql语法条件，Where("id = ?id", new { id = 1 })
+            原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1441,7 +1442,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.LeftJoin(System.String,System.Object)">
             <summary>
-            左联查询，使用原生sql语法，LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+            左联查询，使用原生sql语法，LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1449,7 +1451,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.InnerJoin(System.String,System.Object)">
             <summary>
-            联接查询，使用原生sql语法，InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+            联接查询，使用原生sql语法，InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1457,7 +1460,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.RightJoin(System.String,System.Object)">
             <summary>
-            右联查询，使用原生sql语法，RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+            右联查询，使用原生sql语法，RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1473,7 +1477,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.Where(System.String,System.Object)">
             <summary>
-            原生sql语法条件，Where("id = ?id", new { id = 1 })
+            原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1481,7 +1486,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.WhereIf(System.Boolean,System.String,System.Object)">
             <summary>
-            原生sql语法条件，WhereIf(true, "id = ?id", new { id = 1 })
+            原生sql语法条件，WhereIf(true, "id = ?id", new { id = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="condition">true 时生效</param>
             <param name="sql">sql语法条件</param>
@@ -1520,7 +1526,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.GroupBy(System.String,System.Object)">
             <summary>
-            按原生sql语法分组，GroupBy("concat(name, ?cc)", new { cc = 1 })
+            按原生sql语法分组，GroupBy("concat(name, ?cc)", new { cc = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法</param>
             <param name="parms">参数</param>
@@ -1528,7 +1535,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.Having(System.String,System.Object)">
             <summary>
-            按原生sql语法聚合条件过滤，Having("count(name) = ?cc", new { cc = 1 })
+            按原生sql语法聚合条件过滤，Having("count(name) = ?cc", new { cc = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -1536,7 +1544,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.OrderBy(System.String,System.Object)">
             <summary>
-            按原生sql语法排序，OrderBy("count(name) + ?cc desc", new { cc = 1 })
+            按原生sql语法排序，OrderBy("count(name) + ?cc desc", new { cc = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法</param>
             <param name="parms">参数</param>
@@ -1544,7 +1553,8 @@
         </member>
         <member name="M:FreeSql.ISelect0`2.OrderBy(System.Boolean,System.String,System.Object)">
             <summary>
-            按原生sql语法排序，OrderBy(true, "count(name) + ?cc desc", new { cc = 1 })
+            按原生sql语法排序，OrderBy(true, "count(name) + ?cc desc", new { cc = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="condition">true 时生效</param>
             <param name="sql">sql语法</param>
@@ -2291,7 +2301,8 @@
         </member>
         <member name="M:FreeSql.IUpdate`1.SetRaw(System.String,System.Object)">
             <summary>
-            设置值，自定义SQL语法，SetRaw("title = ?title", new { title = "newtitle" })
+            设置值，自定义SQL语法，SetRaw("title = ?title", new { title = "newtitle" })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法</param>
             <param name="parms">参数</param>
@@ -2317,7 +2328,8 @@
         </member>
         <member name="M:FreeSql.IUpdate`1.Where(System.String,System.Object)">
             <summary>
-            原生sql语法条件，Where("id = ?id", new { id = 1 })
+            原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="sql">sql语法条件</param>
             <param name="parms">参数</param>
@@ -2444,7 +2456,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteReader(System.Action{FreeSql.Internal.Model.FetchCallbackArgs{System.Data.Common.DbDataReader}},System.String,System.Object)">
             <summary>
-            查询，ExecuteReader(dr => {}, "select * from user where age > ?age", new { age = 25 })
+            查询，ExecuteReader(dr => {}, "select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2458,7 +2471,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteArray(System.String,System.Object)">
             <summary>
-            查询，ExecuteArray("select * from user where age > ?age", new { age = 25 })
+            查询，ExecuteArray("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2473,7 +2487,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteDataSet(System.String,System.Object)">
             <summary>
-            查询，ExecuteDataSet("select * from user where age > ?age; select 2", new { age = 25 })
+            查询，ExecuteDataSet("select * from user where age > ?age; select 2", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2488,7 +2503,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteDataTable(System.String,System.Object)">
             <summary>
-            查询，ExecuteDataTable("select * from user where age > ?age", new { age = 25 })
+            查询，ExecuteDataTable("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2504,7 +2520,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteNonQuery(System.String,System.Object)">
             <summary>
-            在【主库】执行，ExecuteNonQuery("delete from user where age > ?age", new { age = 25 })
+            在【主库】执行，ExecuteNonQuery("delete from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2520,7 +2537,8 @@
         </member>
         <member name="M:FreeSql.IAdo.ExecuteScalar(System.String,System.Object)">
             <summary>
-            在【主库】执行，ExecuteScalar("select 1 from user where age > ?age", new { age = 25 })
+            在【主库】执行，ExecuteScalar("select 1 from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <param name="cmdText"></param>
             <param name="parms"></param>
@@ -2538,7 +2556,8 @@
         </member>
         <member name="M:FreeSql.IAdo.Query``1(System.String,System.Object)">
             <summary>
-            执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age", new { age = 25 })
+            执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <typeparam name="T"></typeparam>
             <param name="cmdText"></param>
@@ -2557,7 +2576,147 @@
         </member>
         <member name="M:FreeSql.IAdo.Query``2(System.String,System.Object)">
             <summary>
-            执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new { age = 25 })
+            执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <typeparam name="T1"></typeparam>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteReaderAsync(System.Func{FreeSql.Internal.Model.FetchCallbackArgs{System.Data.Common.DbDataReader},System.Threading.Tasks.Task},System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            查询，若使用读写分离，查询【从库】条件cmdText.StartsWith("SELECT ")，否则查询【主库】
+            </summary>
+            <param name="readerHander"></param>
+            <param name="cmdType"></param>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteReaderAsync(System.Func{FreeSql.Internal.Model.FetchCallbackArgs{System.Data.Common.DbDataReader},System.Threading.Tasks.Task},System.String,System.Object)">
+            <summary>
+            查询，ExecuteReaderAsync(dr => {}, "select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteArrayAsync(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            查询
+            </summary>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteArrayAsync(System.String,System.Object)">
+            <summary>
+            查询，ExecuteArrayAsync("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteDataSetAsync(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            查询
+            </summary>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteDataSetAsync(System.String,System.Object)">
+            <summary>
+            查询，ExecuteDataSetAsync("select * from user where age > ?age; select 2", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteDataTableAsync(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            查询
+            </summary>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteDataTableAsync(System.String,System.Object)">
+            <summary>
+            查询，ExecuteDataTableAsync("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteNonQueryAsync(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            在【主库】执行
+            </summary>
+            <param name="cmdType"></param>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteNonQueryAsync(System.String,System.Object)">
+            <summary>
+            在【主库】执行，ExecuteNonQueryAsync("delete from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteScalarAsync(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            在【主库】执行
+            </summary>
+            <param name="cmdType"></param>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+        </member>
+        <member name="M:FreeSql.IAdo.ExecuteScalarAsync(System.String,System.Object)">
+            <summary>
+            在【主库】执行，ExecuteScalarAsync("select 1 from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.QueryAsync``1(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            执行SQL返回对象集合，QueryAsync&lt;User&gt;("select * from user where age > ?age", new SqlParameter { ParameterName = "age", Value = 25 })
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="cmdType"></param>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.QueryAsync``1(System.String,System.Object)">
+            <summary>
+            执行SQL返回对象集合，QueryAsync&lt;User&gt;("select * from user where age > ?age", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
+            </summary>
+            <typeparam name="T"></typeparam>
+            <param name="cmdText"></param>
+            <param name="parms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.QueryAsync``2(System.Data.CommandType,System.String,System.Data.Common.DbParameter[])">
+            <summary>
+            执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new SqlParameter { ParameterName = "age", Value = 25 })
+            </summary>
+            <typeparam name="T1"></typeparam>
+            <param name="cmdType"></param>
+            <param name="cmdText"></param>
+            <param name="cmdParms"></param>
+            <returns></returns>
+        </member>
+        <member name="M:FreeSql.IAdo.QueryAsync``2(System.String,System.Object)">
+            <summary>
+            执行SQL返回对象集合，Query&lt;User, Address&gt;("select * from user where age > ?age; select * from address", new { age = 25 })<para></para>
+            提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
             </summary>
             <typeparam name="T1"></typeparam>
             <param name="cmdText"></param>
@@ -3233,6 +3392,12 @@
             <param name="timeout">超时</param>
             <returns></returns>
         </member>
+        <member name="M:FreeSql.Internal.ObjectPool.IObjectPool`1.GetAsync">
+            <summary>
+            获取资源
+            </summary>
+            <returns></returns>
+        </member>
         <member name="M:FreeSql.Internal.ObjectPool.IObjectPool`1.Return(FreeSql.Internal.ObjectPool.Object{`0},System.Boolean)">
             <summary>
             使用完毕后，归还资源
@@ -3303,6 +3468,12 @@
             </summary>
             <param name="obj">资源对象</param>
         </member>
+        <member name="M:FreeSql.Internal.ObjectPool.IPolicy`1.OnGetAsync(FreeSql.Internal.ObjectPool.Object{`0})">
+            <summary>
+            从对象池获取对象成功的时候触发，通过该方法统计或初始化对象
+            </summary>
+            <param name="obj">资源对象</param>
+        </member>
         <member name="M:FreeSql.Internal.ObjectPool.IPolicy`1.OnReturn(FreeSql.Internal.ObjectPool.Object{`0})">
             <summary>
             归还对象给对象池的时候触发

FreeSql/Interface/Curd/IDelete.cs

@@ -30,7 +30,8 @@ namespace FreeSql
         /// <returns></returns>
         IDelete<T1> Where(Expression<Func<T1, bool>> exp);
         /// <summary>
-        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })
+        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>

FreeSql/Interface/Curd/ISelect/ISelect0.cs

@@ -218,21 +218,24 @@ namespace FreeSql
         TSelect RightJoin<T2>(Expression<Func<T1, T2, bool>> exp);
 
         /// <summary>
-        /// 左联查询，使用原生sql语法，LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+        /// 左联查询，使用原生sql语法，LeftJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>
         /// <returns></returns>
         TSelect LeftJoin(string sql, object parms = null);
         /// <summary>
-        /// 联接查询，使用原生sql语法，InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+        /// 联接查询，使用原生sql语法，InnerJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>
         /// <returns></returns>
         TSelect InnerJoin(string sql, object parms = null);
         /// <summary>
-        /// 右联查询，使用原生sql语法，RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })
+        /// 右联查询，使用原生sql语法，RightJoin("type b on b.id = a.id and b.clicks > ?clicks", new { clicks = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>
@@ -247,14 +250,16 @@ namespace FreeSql
         TSelect RawJoin(string sql);
 
         /// <summary>
-        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })
+        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>
         /// <returns></returns>
         TSelect Where(string sql, object parms = null);
         /// <summary>
-        /// 原生sql语法条件，WhereIf(true, "id = ?id", new { id = 1 })
+        /// 原生sql语法条件，WhereIf(true, "id = ?id", new { id = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="condition">true 时生效</param>
         /// <param name="sql">sql语法条件</param>
@@ -293,14 +298,16 @@ namespace FreeSql
         TSelect ForUpdate(bool nowait = false);
 
         /// <summary>
-        /// 按原生sql语法分组，GroupBy("concat(name, ?cc)", new { cc = 1 })
+        /// 按原生sql语法分组，GroupBy("concat(name, ?cc)", new { cc = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法</param>
         /// <param name="parms">参数</param>
         /// <returns></returns>
         TSelect GroupBy(string sql, object parms = null);
         /// <summary>
-        /// 按原生sql语法聚合条件过滤，Having("count(name) = ?cc", new { cc = 1 })
+        /// 按原生sql语法聚合条件过滤，Having("count(name) = ?cc", new { cc = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>
@@ -308,14 +315,16 @@ namespace FreeSql
         TSelect Having(string sql, object parms = null);
 
         /// <summary>
-        /// 按原生sql语法排序，OrderBy("count(name) + ?cc desc", new { cc = 1 })
+        /// 按原生sql语法排序，OrderBy("count(name) + ?cc desc", new { cc = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法</param>
         /// <param name="parms">参数</param>
         /// <returns></returns>
         TSelect OrderBy(string sql, object parms = null);
         /// <summary>
-        /// 按原生sql语法排序，OrderBy(true, "count(name) + ?cc desc", new { cc = 1 })
+        /// 按原生sql语法排序，OrderBy(true, "count(name) + ?cc desc", new { cc = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="condition">true 时生效</param>
         /// <param name="sql">sql语法</param>

FreeSql/Interface/Curd/IUpdate.cs

@@ -142,7 +142,8 @@ namespace FreeSql
         /// <returns></returns>
         IUpdate<T1> SetIf<TMember>(bool condition, Expression<Func<T1, TMember>> exp);
         /// <summary>
-        /// 设置值，自定义SQL语法，SetRaw("title = ?title", new { title = "newtitle" })
+        /// 设置值，自定义SQL语法，SetRaw("title = ?title", new { title = "newtitle" })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法</param>
         /// <param name="parms">参数</param>
@@ -167,7 +168,8 @@ namespace FreeSql
         /// <returns></returns>
         IUpdate<T1> Where(Expression<Func<T1, bool>> exp);
         /// <summary>
-        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })
+        /// 原生sql语法条件，Where("id = ?id", new { id = 1 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="sql">sql语法条件</param>
         /// <param name="parms">参数</param>

FreeSql/Interface/IAdo.cs

@@ -66,7 +66,8 @@ namespace FreeSql
         void ExecuteReader(DbTransaction transaction, Action<FetchCallbackArgs<DbDataReader>> fetchHandler, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         void ExecuteReader(DbConnection connection, DbTransaction transaction, Action<FetchCallbackArgs<DbDataReader>> fetchHandler, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteReader(dr => {}, "select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteReader(dr => {}, "select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -82,7 +83,8 @@ namespace FreeSql
         object[][] ExecuteArray(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         object[][] ExecuteArray(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteArray("select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteArray("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -99,7 +101,8 @@ namespace FreeSql
         DataSet ExecuteDataSet(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         DataSet ExecuteDataSet(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteDataSet("select * from user where age > ?age; select 2", new { age = 25 })
+        /// 查询，ExecuteDataSet("select * from user where age > ?age; select 2", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -116,7 +119,8 @@ namespace FreeSql
         DataTable ExecuteDataTable(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         DataTable ExecuteDataTable(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteDataTable("select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteDataTable("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -134,7 +138,8 @@ namespace FreeSql
         int ExecuteNonQuery(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         int ExecuteNonQuery(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 在【主库】执行，ExecuteNonQuery("delete from user where age > ?age", new { age = 25 })
+        /// 在【主库】执行，ExecuteNonQuery("delete from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -152,7 +157,8 @@ namespace FreeSql
         object ExecuteScalar(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         object ExecuteScalar(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 在【主库】执行，ExecuteScalar("select 1 from user where age > ?age", new { age = 25 })
+        /// 在【主库】执行，ExecuteScalar("select 1 from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -174,7 +180,8 @@ namespace FreeSql
         List<T> Query<T>(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         List<T> Query<T>(Type resultType, DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age", new { age = 25 })
+        /// 执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="cmdText"></param>
@@ -196,7 +203,8 @@ namespace FreeSql
         NaviteTuple<List<T1>, List<T2>> Query<T1, T2>(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         NaviteTuple<List<T1>, List<T2>> Query<T1, T2>(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new { age = 25 })
+        /// 执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <typeparam name="T1"></typeparam>
         /// <param name="cmdText"></param>
@@ -239,7 +247,8 @@ namespace FreeSql
         Task ExecuteReaderAsync(DbTransaction transaction, Func<FetchCallbackArgs<DbDataReader>, Task> readerHander, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task ExecuteReaderAsync(DbConnection connection, DbTransaction transaction, Func<FetchCallbackArgs<DbDataReader>, Task> readerHander, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteReaderAsync(dr => {}, "select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteReaderAsync(dr => {}, "select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -255,7 +264,8 @@ namespace FreeSql
         Task<object[][]> ExecuteArrayAsync(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<object[][]> ExecuteArrayAsync(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteArrayAsync("select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteArrayAsync("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -272,7 +282,8 @@ namespace FreeSql
         Task<DataSet> ExecuteDataSetAsync(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<DataSet> ExecuteDataSetAsync(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteDataSetAsync("select * from user where age > ?age; select 2", new { age = 25 })
+        /// 查询，ExecuteDataSetAsync("select * from user where age > ?age; select 2", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -289,7 +300,8 @@ namespace FreeSql
         Task<DataTable> ExecuteDataTableAsync(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<DataTable> ExecuteDataTableAsync(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 查询，ExecuteDataTableAsync("select * from user where age > ?age", new { age = 25 })
+        /// 查询，ExecuteDataTableAsync("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -307,7 +319,8 @@ namespace FreeSql
         Task<int> ExecuteNonQueryAsync(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<int> ExecuteNonQueryAsync(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 在【主库】执行，ExecuteNonQueryAsync("delete from user where age > ?age", new { age = 25 })
+        /// 在【主库】执行，ExecuteNonQueryAsync("delete from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -325,7 +338,8 @@ namespace FreeSql
         Task<object> ExecuteScalarAsync(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<object> ExecuteScalarAsync(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 在【主库】执行，ExecuteScalarAsync("select 1 from user where age > ?age", new { age = 25 })
+        /// 在【主库】执行，ExecuteScalarAsync("select 1 from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <param name="cmdText"></param>
         /// <param name="parms"></param>
@@ -347,7 +361,8 @@ namespace FreeSql
         Task<List<T>> QueryAsync<T>(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<List<T>> QueryAsync<T>(Type resultType, DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 执行SQL返回对象集合，QueryAsync&lt;User&gt;("select * from user where age > ?age", new { age = 25 })
+        /// 执行SQL返回对象集合，QueryAsync&lt;User&gt;("select * from user where age > ?age", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="cmdText"></param>
@@ -369,7 +384,8 @@ namespace FreeSql
         Task<NaviteTuple<List<T1>, List<T2>>> QueryAsync<T1, T2>(DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         Task<NaviteTuple<List<T1>, List<T2>>> QueryAsync<T1, T2>(DbConnection connection, DbTransaction transaction, CommandType cmdType, string cmdText, params DbParameter[] cmdParms);
         /// <summary>
-        /// 执行SQL返回对象集合，Query&lt;User&gt;("select * from user where age > ?age; select * from address", new { age = 25 })
+        /// 执行SQL返回对象集合，Query&lt;User, Address&gt;("select * from user where age > ?age; select * from address", new { age = 25 })<para></para>
+        /// 提示：parms 参数还可以传 Dictionary&lt;string, object&gt;
         /// </summary>
         /// <typeparam name="T1"></typeparam>
         /// <param name="cmdText"></param>