#region 程序集 System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.6.1\System.Data.dll
#endregion
using System.ComponentModel;
using System.Data.Common;
using System.Data.Sql;
using System.Threading;
using System.Threading.Tasks;
using System.Xml;
namespace System.Data.SqlClient
{
//
// 摘要:
// 表示要对 SQL Server 数据库执行的一个 Transact-SQL 语句或存储过程。 此类不能被继承。
[DefaultEvent("RecordsAffected")]
[Designer("Microsoft.VSDesigner.Data.VS.SqlCommandDesigner, Microsoft.VSDesigner, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ToolboxItem(true)]
public sealed class SqlCommand : DbCommand, ICloneable
{
//
// 摘要:
// 初始化 System.Data.SqlClient.SqlCommand 类的新实例。
public SqlCommand();
//
// 摘要:
// 使用查询的文本初始化 System.Data.SqlClient.SqlCommand 类的新实例。
//
// 参数:
// cmdText:
// 查询的文本。
public SqlCommand(string cmdText);
//
// 摘要:
// 使用查询的文本和 System.Data.SqlClient.SqlConnection 初始化 System.Data.SqlClient.SqlCommand
// 类的新实例。
//
// 参数:
// cmdText:
// 查询的文本。
//
// connection:
// 表示到 SQL Server 实例的连接的 System.Data.SqlClient.SqlConnection。
public SqlCommand(string cmdText, SqlConnection connection);
//
// 摘要:
// 使用查询文本、System.Data.SqlClient.SqlConnection 以及 System.Data.SqlClient.SqlTransaction
// 初始化 System.Data.SqlClient.SqlCommand 类的新实例。
//
// 参数:
// cmdText:
// 查询的文本。
//
// connection:
// 表示到 SQL Server 实例的连接的 System.Data.SqlClient.SqlConnection。
//
// transaction:
// 其中执行 System.Data.SqlClient.SqlCommand 的 System.Data.SqlClient.SqlTransaction。
public SqlCommand(string cmdText, SqlConnection connection, SqlTransaction transaction);
//
// 摘要:
// 使用指定的命令文本、连接、事务和加密设置初始化 System.Data.SqlClient.SqlCommand 类的新实例。
//
// 参数:
// cmdText:
// 查询的文本。
//
// connection:
// 表示到 SQL Server 实例的连接的 System.Data.SqlClient.SqlConnection。
//
// transaction:
// 其中执行 System.Data.SqlClient.SqlCommand 的 System.Data.SqlClient.SqlTransaction。
//
// columnEncryptionSetting:
// 加密设置。 有关详细信息，请参阅 Always Encrypted。
public SqlCommand(string cmdText, SqlConnection connection, SqlTransaction transaction, SqlCommandColumnEncryptionSetting columnEncryptionSetting);
//
// 摘要:
// 获取或设置一个值，该值指示应用程序是否应自动接收来自通用 System.Data.SqlClient.SqlDependency 对象的查询通知。
//
// 返回结果:
// 如果应用程序应自动接收查询通知，则为 true；否则为 false。 默认值为 true。
[DefaultValue(true)]
[ResCategoryAttribute("DataCategory_Notification")]
[ResDescriptionAttribute("SqlCommand_NotificationAutoEnlist")]
public bool NotificationAutoEnlist { get; set; }
//
// 摘要:
// 获取或设置一个指定绑定到此命令的 System.Data.Sql.SqlNotificationRequest 对象的值。
//
// 返回结果:
// 如果设置为 null（默认值），则不应请求任何通知。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[ResCategoryAttribute("DataCategory_Notification")]
[ResDescriptionAttribute("SqlCommand_Notification")]
public SqlNotificationRequest Notification { get; set; }
//
// 摘要:
// 获取或设置要在其中执行 System.Data.SqlClient.SqlTransaction 的 System.Data.SqlClient.SqlCommand。
//
// 返回结果:
// System.Data.SqlClient.SqlTransaction。 默认值为 null。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[ResDescriptionAttribute("DbCommand_Transaction")]
public SqlTransaction Transaction { get; set; }
//
// 摘要:
// 获取或设置要在数据源中执行的 Transact-SQL 语句、表名或存储过程。
//
// 返回结果:
// 要执行的 Transact-SQL 语句或存储过程。 默认值为一个空字符串。
[DefaultValue("")]
[Editor("Microsoft.VSDesigner.Data.SQL.Design.SqlCommandTextEditor, Microsoft.VSDesigner, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[RefreshProperties(RefreshProperties.All)]
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("DbCommand_CommandText")]
public override string CommandText { get; set; }
//
// 摘要:
// 获取或设置此命令的列加密设置。
//
// 返回结果:
// 此命令的列加密设置。
[Browsable(false)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("TCE_SqlCommand_ColumnEncryptionSetting")]
public SqlCommandColumnEncryptionSetting ColumnEncryptionSetting { get; }
//
// 摘要:
// 获取或设置在终止尝试执行命令并生成错误之前的等待时间。
//
// 返回结果:
// 等待命令执行所需的时间（以秒为单位）。 默认值为 30 秒。
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("DbCommand_CommandTimeout")]
public override int CommandTimeout { get; set; }
//
// 摘要:
// 获取或设置一个值，该值指示解释 System.Data.SqlClient.SqlCommand.CommandText 属性的方式。
//
// 返回结果:
// System.Data.CommandType 值之一。 默认值为 Text。
//
// 异常:
// T:System.ArgumentException:
// 该值不是有效的 System.Data.CommandType。
[DefaultValue(CommandType.Text)]
[RefreshProperties(RefreshProperties.All)]
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("DbCommand_CommandType")]
public override CommandType CommandType { get; set; }
//
// 摘要:
// 获取或设置一个值，该值指示命令对象是否应在 Windows 窗体设计器控件中可见。
//
// 返回结果:
// 一个指示命令对象是否应在控件中可见的值。 默认值为 true。
[Browsable(false)]
[DefaultValue(true)]
[DesignOnly(true)]
[EditorBrowsable(EditorBrowsableState.Never)]
public override bool DesignTimeVisible { get; set; }
//
// 摘要:
// 获取 System.Data.SqlClient.SqlParameterCollection。
//
// 返回结果:
// Transact-SQL 语句或存储过程的参数。 默认值为空集合。
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("DbCommand_Parameters")]
public SqlParameterCollection Parameters { get; }
//
// 摘要:
// 获取或设置 System.Data.SqlClient.SqlCommand 的此实例使用的 System.Data.SqlClient.SqlConnection。
//
// 返回结果:
// 到数据源的连接。 默认值为 null。
//
// 异常:
// T:System.InvalidOperationException:
// 命令在事务中登记时 System.Data.SqlClient.SqlCommand.Connection 属性被更改。
[DefaultValue(null)]
[Editor("Microsoft.VSDesigner.Data.Design.DbConnectionEditor, Microsoft.VSDesigner, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ResCategoryAttribute("DataCategory_Data")]
[ResDescriptionAttribute("DbCommand_Connection")]
public SqlConnection Connection { get; set; }
//
// 摘要:
// 获取或设置命令结果在由 System.Data.Common.DbDataAdapter 的 Update 方法使用时应用于 System.Data.DataRow
// 的方式。
//
// 返回结果:
// System.Data.UpdateRowSource 值之一。
[DefaultValue(UpdateRowSource.Both)]
[ResCategoryAttribute("DataCategory_Update")]
[ResDescriptionAttribute("DbCommand_UpdatedRowSource")]
public override UpdateRowSource UpdatedRowSource { get; set; }
protected override DbTransaction DbTransaction { get; set; }
protected override DbParameterCollection DbParameterCollection { get; }
protected override DbConnection DbConnection { get; set; }
//
// 摘要:
// 当 Transact-SQL 语句执行完成时发生。
[ResCategoryAttribute("DataCategory_StatementCompleted")]
[ResDescriptionAttribute("DbCommand_StatementCompleted")]
public event StatementCompletedEventHandler StatementCompleted;
//
// 摘要:
// 启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用可返回受影响的行数的 System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)
// 时，也需要该值。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteNonQuery();
//
// 摘要:
// 在给定回调过程和状态信息的情况下，启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行。
//
// 参数:
// callback:
// 命令执行完成时调用的 System.AsyncCallback 委托。 传递 null（在 Microsoft Visual Basic 中为 Nothing）以指示不需要回调。
//
// stateObject:
// 传递到回调过程的用户定义的状态对象。 使用 System.IAsyncResult.AsyncState 属性从回调过程内检索此对象。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用可返回受影响的行数的 System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)
// 时，也需要该值。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteNonQuery(AsyncCallback callback, object stateObject);
//
// 摘要:
// 启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并从服务器中检索一个或多个结果集。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；在调用 System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)
// 时，也需要该值。该调用会返回一个可用于检索返回行的 System.Data.SqlClient.SqlDataReader 实例。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteReader();
//
// 摘要:
// 通过使用 System.Data.CommandBehavior 值之一，启动此 System.Data.SqlClient.SqlCommand 描述的
// Transact-SQL 语句或存储过程的异步执行。
//
// 参数:
// behavior:
// System.Data.CommandBehavior 值之一，指示用于语句执行和数据检索的选项。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用会返回一个可用于检索返回行的 System.Data.SqlClient.SqlDataReader
// 实例的 System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult) 时，也需要该值。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteReader(CommandBehavior behavior);
//
// 摘要:
// 在给定回调过程和状态信息的情况下，通过使用 CommandBehavior 值之一并从服务器中检索一个或多个结果集，启动由此 System.Data.SqlClient.SqlCommand
// 描述的 Transact-SQL 语句或存储过程的异步执行。
//
// 参数:
// callback:
// 命令执行完成时调用的 System.AsyncCallback 委托。 传递 null（在 Microsoft Visual Basic 中为 Nothing）以指示不需要回调。
//
// stateObject:
// 传递到回调过程的用户定义的状态对象。 使用 System.IAsyncResult.AsyncState 属性从回调过程内检索此对象。
//
// behavior:
// System.Data.CommandBehavior 值之一，指示用于语句执行和数据检索的选项。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；在调用 System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)
// 时，也需要该值。该调用会返回一个可用于检索返回行的 System.Data.SqlClient.SqlDataReader 实例。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteReader(AsyncCallback callback, object stateObject, CommandBehavior behavior);
//
// 摘要:
// 在给定回调过程和状态信息的情况下，启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并从服务器中检索一个或多个结果集。
//
// 参数:
// callback:
// 命令执行完成时调用的 System.AsyncCallback 委托。 传递 null（在 Microsoft Visual Basic 中为 Nothing）以指示不需要回调。
//
// stateObject:
// 传递到回调过程的用户定义的状态对象。 使用 System.IAsyncResult.AsyncState 属性从回调过程内检索此对象。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用会返回可用于检索返回行的 System.Data.SqlClient.SqlDataReader
// 实例的 System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult) 时，也需要该值。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteReader(AsyncCallback callback, object stateObject);
//
// 摘要:
// 启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并将结果作为 System.Xml.XmlReader
// 对象返回。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用会返回单个 XML 值的 EndExecuteXmlReader 时，也需要该值。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteXmlReader();
//
// 摘要:
// 通过使用回调过程，启动此 System.Data.SqlClient.SqlCommand 描述的 Transact-SQL 语句或存储过程的异步执行，并将结果作为
// System.Xml.XmlReader 对象返回。
//
// 参数:
// callback:
// 命令执行完成时调用的 System.AsyncCallback 委托。 传递 null（在 Microsoft Visual Basic 中为 Nothing）以指示不需要回调。
//
// stateObject:
// 传递到回调过程的用户定义的状态对象。 使用 System.IAsyncResult.AsyncState 属性从回调过程内检索此对象。
//
// 返回结果:
// 可用于轮询和/或等待结果的 System.IAsyncResult；当调用 System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)
// 时，也需要该值，用于将命令的结果作为 XML 返回。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时出现的任何错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 名称/值对“Asynchronous Processing=true”未包含在为此 System.Data.SqlClient.SqlCommand 定义连接的连接字符串中。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public IAsyncResult BeginExecuteXmlReader(AsyncCallback callback, object stateObject);
//
// 摘要:
// 尝试取消 System.Data.SqlClient.SqlCommand 的执行。
public override void Cancel();
//
// 摘要:
// 创建属于当前实例的副本的新 System.Data.SqlClient.SqlCommand 对象。
//
// 返回结果:
// 属于此实例副本的新 System.Data.SqlClient.SqlCommand 对象。
public SqlCommand Clone();
//
// 摘要:
// 创建 System.Data.SqlClient.SqlParameter 对象的新实例。
//
// 返回结果:
// 一个 System.Data.SqlClient.SqlParameter 对象。
public SqlParameter CreateParameter();
//
// 摘要:
// 完成 Transact-SQL 语句的异步执行。
//
// 参数:
// asyncResult:
// 通过调用 System.IAsyncResult 返回的 System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery。
//
// 返回结果:
// 受影响的行数（与 System.Data.SqlClient.SqlCommand.ExecuteNonQuery 相同的行为）。
//
// 异常:
// T:System.ArgumentException:
// asyncResult 参数为 null（在 Microsoft Visual Basic 中为 Nothing）
//
// T:System.InvalidOperationException:
// 不止一次为单个命令执行调用了 System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)，或该方法不匹配其执行方法（例如，代码调用了
// System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult) 以完成对
// System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader 调用的执行。
//
// T:System.Data.SqlClient.SqlException:
// System.Data.SqlClient.SqlCommand.CommandTimeout 中指定的时间已过，并且使用 Overload:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery
// 指定的异步操作不完整。 在某些情况下，System.IAsyncResult 可能不正确地设置为 IsCompleted。 如果发生这种情况并且调用 System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)，则
// EndExecuteNonQuery 可能引发 SqlException 错误（如果 System.Data.SqlClient.SqlCommand.CommandTimeout
// 中指定的时间已过，并且使用 Overload:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery
// 指定的异步操作不完整）。 若要更正这种情况，应增加 CommandTimeout 的值或减少正由异步操作完成的工作。
public int EndExecuteNonQuery(IAsyncResult asyncResult);
//
// 摘要:
// 完成 Transact-SQL 语句的异步执行，从而返回请求的 System.Data.SqlClient.SqlDataReader。
//
// 参数:
// asyncResult:
// 通过调用 System.IAsyncResult 返回的 System.Data.SqlClient.SqlCommand.BeginExecuteReader。
//
// 返回结果:
// 可用于检索请求行的 System.Data.SqlClient.SqlDataReader 对象。
//
// 异常:
// T:System.ArgumentException:
// asyncResult 参数为 null（在 Microsoft Visual Basic 中为 Nothing）
//
// T:System.InvalidOperationException:
// 不止一次为单个命令执行调用了 System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)，或该方法不匹配其执行方法（例如，代码调用了
// System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult) 以完成对 System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader
// 调用的执行。
public SqlDataReader EndExecuteReader(IAsyncResult asyncResult);
//
// 摘要:
// 完成 Transact-SQL 语句的异步执行，从而将请求的数据以 XML 形式返回。
//
// 参数:
// asyncResult:
// 通过调用 System.IAsyncResult 返回的 System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader。
//
// 返回结果:
// 可用于获取生成的 XML 数据的 System.Xml.XmlReader 对象。
//
// 异常:
// T:System.ArgumentException:
// asyncResult 参数为 null（在 Microsoft Visual Basic 中为 Nothing）
//
// T:System.InvalidOperationException:
// 不止一次为单个命令执行调用了 System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)，或该方法不匹配其执行方法（例如，代码调用了
// System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult) 以完成对
// System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery 调用的执行。
public XmlReader EndExecuteXmlReader(IAsyncResult asyncResult);
//
// 摘要:
// 对连接执行 Transact-SQL 语句并返回受影响的行数。
//
// 返回结果:
// 受影响的行数。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 对锁定的行执行命令时出现异常。 当使用 Microsoft .NET Framework 1.0 版时不生成此异常。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅
// SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public override int ExecuteNonQuery();
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteNonQuery 的异步版本，它对连接执行 Transact-SQL 语句并返回受影响的行数。
// 取消标记可用于请求在命令超时超过前放弃操作。 将通过返回的任务对象报告异常。
//
// 参数:
// cancellationToken:
// 取消指令。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteNonQueryAsync(System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public override Task<int> ExecuteNonQueryAsync(CancellationToken cancellationToken);
//
// 摘要:
// 将 System.Data.SqlClient.SqlCommand.CommandText 发送到 System.Data.SqlClient.SqlCommand.Connection，并使用
// System.Data.CommandBehavior 值之一生成 System.Data.SqlClient.SqlDataReader。
//
// 参数:
// behavior:
// System.Data.CommandBehavior 值之一。
//
// 返回结果:
// 一个 System.Data.SqlClient.SqlDataReader 对象。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public SqlDataReader ExecuteReader(CommandBehavior behavior);
//
// 摘要:
// 将 System.Data.SqlClient.SqlCommand.CommandText 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成
// System.Data.SqlClient.SqlDataReader。
//
// 返回结果:
// 一个 System.Data.SqlClient.SqlDataReader 对象。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 对锁定的行执行命令时出现异常。 当使用 Microsoft .NET Framework 1.0 版时不生成此异常。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅
// SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 连接的当前状态已关闭。 System.Data.SqlClient.SqlCommand.ExecuteReader 需要打开 System.Data.SqlClient.SqlConnection。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public SqlDataReader ExecuteReader();
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteReader(System.Data.CommandBehavior) 的异步版本，它可以将
// System.Data.SqlClient.SqlCommand.CommandText 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成
// System.Data.SqlClient.SqlDataReader。 取消标记可用于请求在命令超时超过前放弃操作。 将通过返回的任务对象报告异常。
//
// 参数:
// behavior:
// 语句执行和数据检索的选项。 当设置为 Default 时，System.Data.SqlClient.SqlDataReader.ReadAsync(System.Threading.CancellationToken)
// 将在返回完整任务前读取整行。
//
// cancellationToken:
// 取消指令。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.ArgumentException:
// 无效的 System.Data.CommandBehavior 值。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteReaderAsync(System.Data.CommandBehavior,System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<SqlDataReader> ExecuteReaderAsync(CommandBehavior behavior, CancellationToken cancellationToken);
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteReader 的异步版本，它可以将 System.Data.SqlClient.SqlCommand.CommandText
// 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成 System.Data.SqlClient.SqlDataReader。
// 取消标记可用于请求在命令超时超过前放弃操作。 将通过返回的任务对象报告异常。
//
// 参数:
// cancellationToken:
// 取消指令。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.ArgumentException:
// 无效的 System.Data.CommandBehavior 值。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteReaderAsync(System.Data.CommandBehavior,System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<SqlDataReader> ExecuteReaderAsync(CancellationToken cancellationToken);
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteReader(System.Data.CommandBehavior) 的异步版本，用于将
// System.Data.SqlClient.SqlCommand.CommandText 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成一个
// System.Data.SqlClient.SqlDataReader。 将通过返回的任务对象报告异常。
//
// 参数:
// behavior:
// 语句执行和数据检索的选项。 当设置为 Default 时，System.Data.SqlClient.SqlDataReader.ReadAsync(System.Threading.CancellationToken)
// 将在返回完整任务前读取整行。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.ArgumentException:
// 无效的 System.Data.CommandBehavior 值。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteReaderAsync(System.Data.CommandBehavior)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<SqlDataReader> ExecuteReaderAsync(CommandBehavior behavior);
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteReader 的异步版本，它可以将 System.Data.SqlClient.SqlCommand.CommandText
// 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成 System.Data.SqlClient.SqlDataReader。
// 将通过返回的任务对象报告异常。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.ArgumentException:
// 无效的 System.Data.CommandBehavior 值。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteReaderAsync。 流式处理操作期间关闭或删除了
// System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 在连接字符串中指定
// Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<SqlDataReader> ExecuteReaderAsync();
//
// 摘要:
// 执行查询，并返回由查询返回的结果集中的第一行的第一列。 其他列或行将被忽略。
//
// 返回结果:
// 为结果集中的第一行的第一列，或者，如果结果集为空，则为 null 引用（在 Visual Basic 中为 Nothing）。 返回的最大字符数为 2033
// 个字符。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 对锁定的行执行命令时出现异常。 当使用 Microsoft .NET Framework 1.0 版时不生成此异常。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅
// SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public override object ExecuteScalar();
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteScalar 的异步版本，该版本异步执行查询，并返回由查询返回的结果集中的第一行的第一列。
// 其他列或行将被忽略。 取消标记可用于请求在命令超时超过前放弃操作。 将通过返回的任务对象报告异常。
//
// 参数:
// cancellationToken:
// 取消指令。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteScalarAsync(System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public override Task<object> ExecuteScalarAsync(CancellationToken cancellationToken);
//
// 摘要:
// 将 System.Data.SqlClient.SqlCommand.CommandText 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成一个
// System.Xml.XmlReader 对象。
//
// 返回结果:
// 一个 System.Xml.XmlReader 对象。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.Data.SqlClient.SqlException:
// 对锁定的行执行命令时出现异常。 当使用 Microsoft .NET Framework 1.0 版时不生成此异常。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅
// SqlClient 流支持。
//
// T:System.InvalidOperationException:
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public XmlReader ExecuteXmlReader();
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteXmlReader 的异步版本，可以将 System.Data.SqlClient.SqlCommand.CommandText
// 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成 System.Xml.XmlReader 对象。
// 将通过返回的任务对象报告异常。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteScalarAsync(System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<XmlReader> ExecuteXmlReaderAsync();
//
// 摘要:
// System.Data.SqlClient.SqlCommand.ExecuteXmlReader 的异步版本，可以将 System.Data.SqlClient.SqlCommand.CommandText
// 发送到 System.Data.SqlClient.SqlCommand.Connection，并生成 System.Xml.XmlReader 对象。
// 取消标记可用于请求在命令超时超过前放弃操作。 将通过返回的任务对象报告异常。
//
// 参数:
// cancellationToken:
// 取消指令。
//
// 返回结果:
// 表示异步操作的任务。
//
// 异常:
// T:System.InvalidCastException:
// 将 System.Data.SqlClient.SqlParameter.Value 设置为 System.IO.Stream 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Binary 或 VarBinary。 有关流式处理的详细信息，请参阅 SqlClient 流支持。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.IO.TextReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Char、NChar、NVarChar、VarChar 或 Xml。 将 System.Data.SqlClient.SqlParameter.Value
// 设置为 System.Xml.XmlReader 时，使用的是 System.Data.SqlClient.SqlParameter.SqlDbType
// 而不是 Xml。
//
// T:System.InvalidOperationException:
// 在完成任务前，为同一个实例多次调用 System.Data.SqlClient.SqlCommand.ExecuteScalarAsync(System.Threading.CancellationToken)。
// 流式处理操作期间关闭或删除了 System.Data.SqlClient.SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient
// 流支持。 在连接字符串中指定 Context Connection=true。
//
// T:System.Data.SqlClient.SqlException:
// 执行命令文本时，SQL Server 返回了一个错误。 流式处理操作期间发生了超时。 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.IO.IOException:
// 流式处理操作期间在 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象中出现了错误。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
//
// T:System.ObjectDisposedException:
// 流式处理操作期间关闭了 System.IO.Stream、System.Xml.XmlReader 或 System.IO.TextReader 对象。
// 有关流式处理的详细信息，请参阅 SqlClient 流支持。
public Task<XmlReader> ExecuteXmlReaderAsync(CancellationToken cancellationToken);
//
// 摘要:
// 在 SQL Server 的实例上创建命令的一个准备版本。
public override void Prepare();
//
// 摘要:
// 将 System.Data.SqlClient.SqlCommand.CommandTimeout 属性重置为其默认值。
public void ResetCommandTimeout();
protected override DbParameter CreateDbParameter();
protected override void Dispose(bool disposing);
protected override DbDataReader ExecuteDbDataReader(CommandBehavior behavior);
protected override Task<DbDataReader> ExecuteDbDataReaderAsync(CommandBehavior behavior, CancellationToken cancellationToken);
}
}
