Язык

SqlBulkCopy.WriteToServerAsync Метод

Определение

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

Перегрузки

Имя. Описание
WriteToServerAsync(IDataReader, CancellationToken)

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
WriteToServerAsync(DbDataReader)

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(DataRow[])

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(DataTable)

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(IDataReader)

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(DbDataReader, CancellationToken)

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(DataRow[], CancellationToken)

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

      <p>The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.</p>
      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
WriteToServerAsync(DataTable, DataRowState)

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.
WriteToServerAsync(DataTable, CancellationToken)

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
WriteToServerAsync(DataTable, DataRowState, CancellationToken)

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

Комментарии

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

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

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

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

WriteToServerAsync(IDataReader, CancellationToken)

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

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DbDataReader)

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DataRow[])

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DataTable)

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(IDataReader)

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DbDataReader, CancellationToken)

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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)

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

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

      <p>The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.</p>
      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DataTable, DataRowState)

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

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

Для новой разработки используйте Microsoft. Data.SqlClient. На этой странице приведены документы System.Data.SqlClient.

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DataTable, CancellationToken)

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

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

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

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

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

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

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

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