SqlBulkCopy.WriteToServerAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
WriteToServerAsync(DataTable, CancellationToken)
WriteToServer(DataTable) 的异步版本，将 DataTable 中提供的所有行都复制到 DestinationTableName 对象的 SqlBulkCopy 属性指定的目标表中。
取消标记可用于在命令超时超过前请求放弃操作。 将通过返回的任务对象报告异常。
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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task参数
- cancellationToken
- CancellationToken
取消指示。 此参数中的 None 值让方法等效于 WriteToServerAsync(DataTable)。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataTable)。
在任务完成之前为同一个实例调用 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。
在 WriteToServerAsync(DataTable) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task参数
- rowState
- DataRowState
DataRowState 枚举中的一个值。 只有与行状态匹配的行才会被复制到目标表中。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataTable, DataRowState)。
在任务完成之前为同一个实例调用 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。
在 WriteToServerAsync(DataTable, DataRowState) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task参数
- cancellationToken
- CancellationToken
取消指示。 此参数中的 None 值让方法等效于 WriteToServerAsync(DataTable)。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataRow[])。
在任务完成之前为同一个实例调用 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。
在 WriteToServerAsync(DataRow[]) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task参数
- reader
- DbDataReader
一个 DbDataReader，它的行将被复制到目标表中。
- cancellationToken
- CancellationToken
取消指示。 此参数中的 None 值让方法等效于 WriteToServerAsync(DbDataReader)。
返回
表示异步操作的任务。
适用于
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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task参数
- rowState
- DataRowState
DataRowState 枚举中的一个值。 只有与行状态匹配的行才会被复制到目标表中。
- cancellationToken
- CancellationToken
取消指示。 此参数中的 None 值让方法等效于 WriteToServerAsync(DataTable)。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataTable, DataRowState)。
在任务完成之前为同一个实例调用 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。
在 WriteToServerAsync(DataTable, DataRowState) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
WriteToServerAsync(DataTable)
WriteToServer(DataTable) 的异步版本，将 DataTable 中提供的所有行都复制到 DestinationTableName 对象的 SqlBulkCopy 属性指定的目标表中。
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.TaskPublic Function WriteToServerAsync (table As DataTable) As Task参数
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataTable)。
在任务完成之前为同一个实例调用 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。
在 WriteToServerAsync(DataTable) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As Task参数
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(DataRow[])。 在任务完成之前为同一个实例调用 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。
在 WriteToServerAsync(DataRow[]) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
WriteToServerAsync(DbDataReader)
WriteToServer(IDataReader) 的异步版本，将 IDataReader 中提供的所有行都复制到 DestinationTableName 对象的 SqlBulkCopy 属性指定的目标表中。
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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As Task参数
- reader
- DbDataReader
一个 IDataReader，它的行将被复制到目标表中。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(IDataReader)。
在任务完成之前为同一个实例调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
在 IDataReader 返回之前， Task 已关闭。
在 IDataReader 返回之前，与 Task 相关的连接已关闭。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
WriteToServerAsync(IDataReader, CancellationToken)
WriteToServer(IDataReader) 的异步版本，将 IDataReader 中提供的所有行都复制到 DestinationTableName 对象的 SqlBulkCopy 属性指定的目标表中。
取消标记可用于在命令超时超过前请求放弃操作。 将通过返回的任务对象报告异常。
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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task参数
- reader
- IDataReader
一个 IDataReader，它的行将被复制到目标表中。
- cancellationToken
- CancellationToken
取消指示。 此参数中的 None 值让方法等效于 WriteToServerAsync(DataTable)。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(IDataReader)。
在任务完成之前为同一个实例调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
在 IDataReader 返回之前， Task 已关闭。
在 IDataReader 返回之前，与 Task 相关的连接已关闭。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。
适用于
WriteToServerAsync(IDataReader)
WriteToServer(IDataReader) 的异步版本，将 IDataReader 中提供的所有行都复制到 DestinationTableName 对象的 SqlBulkCopy 属性指定的目标表中。
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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As Task参数
- reader
- IDataReader
一个 IDataReader，它的行将被复制到目标表中。
返回
表示异步操作的任务。
例外
在完成任务前，为同一个实例多次调用 WriteToServerAsync(IDataReader)。
在任务完成之前为同一个实例调用 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 执行期间，连接中断或在数据检索期间已关闭。
在任务对象中返回，方法执行期间，SqlBulkCopy 对象处于关闭状态。
在任务对象中返回，出现连接池超时。
在任务对象中返回，方法执行前，SqlConnection 对象处于关闭状态。
在 IDataReader 返回之前， Task 已关闭。
在 IDataReader 返回之前，与 Task 相关的连接已关闭。
SqlBulkCopyColumnOrderHint未指定有效的目标列名。
由 SQL Server 在任务对象中返回的任意错误，这些错误是打开连接时出现的。
注解
有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。