#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);
}
}