SqlBulkCopy.WriteToServerAsync Метод

Определение

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

System.Data.SqlClient

Сборка:

System.Data.SqlClient.dll

Пакет:

System.Data.SqlClient v4.8.6

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

Перегрузки

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

Комментарии

Если несколько активных результирующих наборов (MARS) отключены, WriteToServer подключение будет занято. Если параметр MARS включен, вызовы можно чередовать WriteToServer с другими командами в том же соединении.

Количество строк, откат которых выполняется при сбое одной из них, зависит от нескольких факторов:

• Значение , если UseInternalTransaction задано значение .

• Если у вас есть собственная транзакция.

• Значение BatchSize.

При возникновении ошибки при отправке данных на сервер выполняется откат текущего пакета (как указано в BatchSize). Если UseInternalTransaction параметр не указан и у вас есть собственная транзакция, будет откат всей транзакции (которая также включает все предыдущие пакеты).

Используйте , SqlRowsCopied чтобы узнать, сколько строк было скопировано на сервер.

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.

Context Connection=true задается в строке подключения.

SqlException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader)

Асинхронная версия объекта WriteToServer(DbDataReader), который копирует все строки из предоставленного массива DbDataReader в целевую таблицу, заданную свойством 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

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

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

Task

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

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DbDataReader).

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

Context Connection=true задается в строке подключения.

SqlException

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

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataRow[]).

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

Context Connection=true задается в строке подключения.

SqlException

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

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataTable).

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.

Context Connection=true задается в строке подключения.

SqlException

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

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(IDataReader).

WriteToServerAsync(DbDataReader, CancellationToken)

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

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

Возвращает Task.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DbDataReader).

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

Context Connection=true задается в строке подключения.

SqlException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataRow[]).

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

Context Connection=true задается в строке подключения.

SqlException

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

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataTable, DataRowState).

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

Context Connection=true задается в строке подключения.

SqlException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataTable).

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

Context Connection=true задается в строке подключения.

SqlException

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

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые WriteToServer(DataTable, DataRowState).