SqlBulkCopy.WriteToServerAsync 方法

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v7.0.1

重载

名称	说明
WriteToServerAsync(DbDataReader)	异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。
WriteToServerAsync(DataRow[])	异步版本的 WriteToServer(DataRow[])，它将提供DataRow数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。
WriteToServerAsync(DataTable)	异步版本的 WriteToServer(DataTable)，它将提供DataTable的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。
WriteToServerAsync(IDataReader)	异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。
WriteToServerAsync(DbDataReader, CancellationToken)	异步版本的 WriteToServer(DbDataReader)，它将提供DbDataReader数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
WriteToServerAsync(DataRow[], CancellationToken)	异步版本的 WriteToServer(DataRow[])，它将提供DataRow数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
WriteToServerAsync(DataTable, DataRowState)	异步版本的 WriteToServer(DataTable, DataRowState) 仅复制与所提供DataTable行状态匹配的行，该行由对象属性SqlBulkCopy指定的DestinationTableName目标表。
WriteToServerAsync(DataTable, CancellationToken)	异步版本的 WriteToServer(DataTable)，它将提供DataTable的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
WriteToServerAsync(IDataReader, CancellationToken)	异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	异步版本的 WriteToServer(DataTable, DataRowState) 仅复制与所提供DataTable行状态匹配的行，该行由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

WriteToServerAsync(DbDataReader)

异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.Common.DbDataReader reader);

member this.WriteToServerAsync : System.Data.Common.DbDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader) As Task

参数

reader

DbDataReader

IDataReader其行将复制到目标表。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(IDataReader) 。
• 在任务完成之前调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(IDataReader) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• 在 IDataReader 完成 Task 返回之前关闭了。
• 在 IDataReader 返回完成 Task 之前关闭了关联的连接。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DataRow[])

异步版本的 WriteToServer(DataRow[])，它将提供DataRow数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataRow[] rows);

member this.WriteToServerAsync : System.Data.DataRow[] -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow()) As Task

参数

rows

DataRow[]

将复制到目标表的对象数组 DataRow 。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataRow[]) 。 在任务完成之前调用 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[]) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataRow[]) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DataTable)

异步版本的 WriteToServer(DataTable)，它将提供DataTable的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataTable table);

member this.WriteToServerAsync : System.Data.DataTable -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable) As Task

参数

table

DataTable

DataTable其行将复制到目标表。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataTable) 。
• 在任务完成之前调用 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataTable) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(IDataReader)

异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.IDataReader reader);

member this.WriteToServerAsync : System.Data.IDataReader -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader) As Task

参数

reader

IDataReader

IDataReader其行将复制到目标表。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(IDataReader) 。
• 在任务完成之前调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(IDataReader) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• 在 IDataReader 完成 Task 返回之前关闭了。
• 在 IDataReader 返回完成 Task 之前关闭了关联的连接。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DbDataReader, CancellationToken)

异步版本的 WriteToServer(DbDataReader)，它将提供DbDataReader数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.Common.DbDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.Common.DbDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task

参数

reader

DbDataReader

DbDataReader其行将复制到目标表。

cancellationToken

CancellationToken

取消指令。 None此参数中的值使此方法等效 WriteToServerAsync(DbDataReader)。

返回

Task

表示异步操作的任务。

WriteToServerAsync(DataRow[], CancellationToken)

异步版本的 WriteToServer(DataRow[])，它将提供DataRow数组中的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataRow[] rows, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataRow[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

参数

rows

DataRow[]

将复制到目标表的对象数组 DataRow 。

cancellationToken

CancellationToken

取消指令。 None此参数中的值使此方法等效 WriteToServerAsync(DataTable)。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataRow[]) 。
• 在任务完成之前调用 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[]) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataRow[]) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DataTable, DataRowState)

异步版本的 WriteToServer(DataTable, DataRowState) 仅复制与所提供DataTable行状态匹配的行，该行由对象属性SqlBulkCopy指定的DestinationTableName目标表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataTable table, System.Data.DataRowState rowState);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

参数

table

DataTable

DataTable其行将复制到目标表。

rowState

DataRowState

枚举中的 DataRowState 值。 仅将与行状态匹配的行复制到目标。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataTable, DataRowState) 。
• 在任务完成之前调用 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataTable, DataRowState) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DataTable, CancellationToken)

异步版本的 WriteToServer(DataTable)，它将提供DataTable的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataTable table, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task

参数

table

DataTable

DataTable其行将复制到目标表。

cancellationToken

CancellationToken

取消指令。 None此参数中的值使此方法等效 WriteToServerAsync(DataTable)。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataTable) 。
• 在任务完成之前调用 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataTable) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(IDataReader, CancellationToken)

异步版本的 WriteToServer(IDataReader)，它将提供IDataReader的所有行复制到由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.IDataReader reader, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.IDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task

参数

reader

IDataReader

IDataReader其行将复制到目标表。

cancellationToken

CancellationToken

取消指令。 None此参数中的值使此方法等效 WriteToServerAsync(DataTable)。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(IDataReader) 。
• 在任务完成之前调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(IDataReader) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• 在 IDataReader 完成 Task 返回之前关闭了。
• 在 IDataReader 返回完成 Task 之前关闭了关联的连接。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

异步版本的 WriteToServer(DataTable, DataRowState) 仅复制与所提供DataTable行状态匹配的行，该行由对象属性SqlBulkCopy指定的DestinationTableName目标表。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WriteToServerAsync(System.Data.DataTable table, System.Data.DataRowState rowState, System.Threading.CancellationToken cancellationToken);

member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task

参数

table

DataTable

DataTable其行将复制到目标表。

rowState

DataRowState

枚举中的 DataRowState 值。 仅将与行状态匹配的行复制到目标。

cancellationToken

CancellationToken

取消指令。 None此参数中的值使此方法等效 WriteToServerAsync(DataTable)。

返回

Task

表示异步操作的任务。

例外

InvalidOperationException

• 在任务完成之前为同一实例多次调用 WriteToServerAsync(DataTable, DataRowState) 。
• 在任务完成之前调用 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState) 调用同一实例。
• 连接在执行过程中 WriteToServerAsync(DataTable, DataRowState) 会删除或关闭。
• 在任务对象中返回，在 SqlBulkCopy 方法执行期间关闭对象。
• 在任务对象中返回，存在连接池超时。
• 在任务对象中返回，在 SqlConnection 方法执行之前关闭该对象。
• A SqlBulkCopyColumnOrderHint 未指定有效的目标列名称。

SqlException

在任务对象中返回，打开连接时SQL Server返回的任何错误。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。