SqlBulkCopy.WriteToServerAsync Метод

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.dll

Сборка:: System.Data.SqlClient.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Асинхронная версия 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)

Исходный код:: System.Data.SqlClient.notsupported.cs

Асинхронная версия 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

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

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

Применяется к

WriteToServerAsync(DbDataReader)

Исходный код:: System.Data.SqlClient.notsupported.cs

Асинхронная версия 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

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

Применяется к

WriteToServerAsync(DataRow[])

Исходный код:: System.Data.SqlClient.notsupported.cs

Асинхронная версия 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 при открытии подключения.

Применяется к

WriteToServerAsync(DataTable)

Исходный код:: System.Data.SqlClient.notsupported.cs

Асинхронная версия 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 при открытии подключения.

Применяется к

WriteToServerAsync(IDataReader)

Исходный код:: System.Data.SqlClient.notsupported.cs

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 при открытии подключения.

Применяется к

WriteToServerAsync(DbDataReader, CancellationToken)

Исходный код:: System.Data.SqlClient.notsupported.cs

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

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

Применяется к

WriteToServerAsync(DataRow[], CancellationToken)

Исходный код:: System.Data.SqlClient.notsupported.cs

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

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

Применяется к

WriteToServerAsync(DataTable, DataRowState)

Исходный код:: System.Data.SqlClient.notsupported.cs

Асинхронная версия 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 при открытии подключения.

Применяется к

WriteToServerAsync(DataTable, CancellationToken)

Исходный код:: System.Data.SqlClient.notsupported.cs

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

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

Применяется к

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Исходный код:: System.Data.SqlClient.notsupported.cs

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

cancellationToken: CancellationToken

Инструкция отмены. Значение в этом параметре None эквивалентно этому методу WriteToServerAsync(DataTable).

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

Task

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

Исключения

InvalidOperationException

Вызов WriteToServerAsync(DataTable, DataRowState) нескольких раз для одного экземпляра перед завершением задачи.

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

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

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

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

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

SqlException

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

OperationCanceledException

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

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

SqlBulkCopy.WriteToServerAsync Метод

Определение

Перегрузки

Комментарии

WriteToServerAsync(IDataReader, CancellationToken)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DbDataReader)

Параметры

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

Комментарии

Применяется к

WriteToServerAsync(DataRow[])

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DataTable)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(IDataReader)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DbDataReader, CancellationToken)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DataRow[], CancellationToken)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DataTable, DataRowState)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DataTable, CancellationToken)

Параметры

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

Исключения

Комментарии

Применяется к

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

Параметры

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

Исключения

Комментарии

Применяется к

Обратная связь