SqlBulkCopy.WriteToServerAsync Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

WriteToServerAsync(DataTable, CancellationToken)	Асинхронная версия метода WriteToServer(DataTable), который копирует все строки из предоставленного DataTable в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy. Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.
WriteToServerAsync(DataTable, DataRowState)	Асинхронная версия объекта WriteToServer(DataTable, DataRowState), который копирует только те строки, которые соответствуют состоянию предоставленных строк в предоставленном DataTable для целевой таблицы, заданной свойством DestinationTableName объекта SqlBulkCopy.
WriteToServerAsync(DataRow[], CancellationToken)	Асинхронная версия объекта WriteToServer(DataRow[]), который копирует все строки из предоставленного массива DataRow в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy. Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.
WriteToServerAsync(DbDataReader, CancellationToken)	Асинхронная версия объекта WriteToServer(DbDataReader), который копирует все строки из предоставленного массива DbDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy. Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Асинхронная версия объекта WriteToServer(DataTable, DataRowState), который копирует только те строки, которые соответствуют состоянию предоставленных строк в предоставленном DataTable для целевой таблицы, заданной свойством DestinationTableName объекта SqlBulkCopy. Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.
WriteToServerAsync(DataTable)	Асинхронная версия метода WriteToServer(DataTable), который копирует все строки из предоставленного DataTable в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.
WriteToServerAsync(DataRow[])	Асинхронная версия объекта WriteToServer(DataRow[]), который копирует все строки из предоставленного массива DataRow в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.
WriteToServerAsync(DbDataReader)	Асинхронная версия метода WriteToServer(IDataReader), который копирует все строки из предоставленного IDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.
WriteToServerAsync(IDataReader, CancellationToken)	Асинхронная версия метода WriteToServer(IDataReader), который копирует все строки из предоставленного IDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy. Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.
WriteToServerAsync(IDataReader)	Асинхронная версия метода WriteToServer(IDataReader), который копирует все строки из предоставленного IDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

WriteToServerAsync(DataTable, CancellationToken)

Асинхронная версия метода WriteToServer(DataTable), который копирует все строки из предоставленного DataTable в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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 закрыт до выполнения метода.

Параметр SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в разделе Асинхронное программирование.

WriteToServerAsync(DataTable, DataRowState)

Асинхронная версия объекта WriteToServer(DataTable, DataRowState), который копирует только те строки, которые соответствуют состоянию предоставленных строк в предоставленном DataTable для целевой таблицы, заданной свойством DestinationTableName объекта SqlBulkCopy.

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 закрыт до выполнения метода.

Параметр SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в разделе Асинхронное программирование.

WriteToServerAsync(DataRow[], CancellationToken)

Асинхронная версия объекта WriteToServer(DataRow[]), который копирует все строки из предоставленного массива DataRow в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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 закрыт до выполнения метода.

Параметр SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в разделе Асинхронное программирование.

WriteToServerAsync(DbDataReader, CancellationToken)

Асинхронная версия объекта WriteToServer(DbDataReader), который копирует все строки из предоставленного массива DbDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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(DataTable, DataRowState, CancellationToken)

Асинхронная версия объекта WriteToServer(DataTable, DataRowState), который копирует только те строки, которые соответствуют состоянию предоставленных строк в предоставленном DataTable для целевой таблицы, заданной свойством DestinationTableName объекта SqlBulkCopy.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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 закрыт до выполнения метода.

Параметр SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для 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.Task

Public Function WriteToServerAsync (table As DataTable) As Task

Параметры

table

DataTable

Объект DataTable, строки которого будут скопированы в таблицу назначения.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию.

Исключения

InvalidOperationException

Многократный вызов WriteToServerAsync(DataTable) для одного и того же экземпляра до завершения задачи.

Вызов методов WriteToServerAsync(DataTable) и WriteToServer(DataTable) для одного экземпляра до завершения задачи.

Соединение разъединяется или закрывается во время выполнения метода WriteToServerAsync(DataTable).

Возвращается в объекте задачи, объект SqlBulkCopy был закрыт во время выполнения метода.

Возвращается в объекте задачи, истекло время ожидания пула подключений.

Возвращается в объекте задачи, объект SqlConnection закрыт до выполнения метода.

Объект SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в статье Асинхронное программирование.

WriteToServerAsync(DataRow[])

Асинхронная версия объекта WriteToServer(DataRow[]), который копирует все строки из предоставленного массива DataRow в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

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 закрыт до выполнения метода.

Объект SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для 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.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.

Объект SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в статье Асинхронное программирование.

WriteToServerAsync(IDataReader, CancellationToken)

Асинхронная версия метода WriteToServer(IDataReader), который копирует все строки из предоставленного IDataReader в целевую таблицу, заданную свойством DestinationTableName объекта SqlBulkCopy.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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.

Объект SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для 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.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.

Объект SqlBulkCopyColumnOrderHint не указал допустимое имя целевого столбца.

SqlException

Возвращается в объекте задачи, любая ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в статье Асинхронное программирование.