SqlBulkCopy.WriteToServerAsync Метод

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v7.0.1

Перегрузки

Имя	Описание
WriteToServerAsync(DbDataReader)	Асинхронная версия WriteToServer(IDataReader), которая копирует все строки в предоставленной IDataReader в целевую таблицу, указанную 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 объекта. Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.
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(IDataReader, CancellationToken)	Асинхронная версия WriteToServer(IDataReader), которая копирует все строки в предоставленной IDataReader в целевую таблицу, указанную DestinationTableName свойством SqlBulkCopy объекта. Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	Асинхронная версия WriteToServer(DataTable, DataRowState), которая копирует только строки, соответствующие заданному состоянию строки в указанной DataTable целевой таблице, указанной DestinationTableName свойством SqlBulkCopy объекта. Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(IDataReader) вызов WriteToServerAsync(IDataReader) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(IDataReader) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Он IDataReader был закрыт до Task завершения возврата.
• IDataReader Связанное подключение было закрыто до завершения Task возврата.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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[]) нескольких раз для одного экземпляра перед завершением задачи. Вызов и WriteToServer(DataRow[]) вызов WriteToServerAsync(DataRow[]) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataRow[]) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(DataTable) вызов WriteToServerAsync(DataTable) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataTable) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(IDataReader) вызов WriteToServerAsync(IDataReader) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(IDataReader) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Он IDataReader был закрыт до Task завершения возврата.
• IDataReader Связанное подключение было закрыто до завершения Task возврата.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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(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[]) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(DataRow[]) вызов WriteToServerAsync(DataRow[]) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataRow[]) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(DataTable, DataRowState) вызов WriteToServerAsync(DataTable, DataRowState) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataTable, DataRowState) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(DataTable) вызов WriteToServerAsync(DataTable) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataTable) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(IDataReader) вызов WriteToServerAsync(IDataReader) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(IDataReader) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Он IDataReader был закрыт до Task завершения возврата.
• IDataReader Связанное подключение было закрыто до завершения Task возврата.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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

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) нескольких раз для одного экземпляра перед завершением задачи.
• Вызов и WriteToServer(DataTable, DataRowState) вызов WriteToServerAsync(DataTable, DataRowState) одного и того же экземпляра перед завершением задачи.
• Соединение удаляется или закрывается во время WriteToServerAsync(DataTable, DataRowState) выполнения.
• Возвращенный в объекте SqlBulkCopy задачи объект был закрыт во время выполнения метода.
• Возвращено в объекте задачи время ожидания пула соединений.
• Возвращается в объекте задачи, SqlConnection объект закрывается перед выполнением метода.
• Не SqlBulkCopyColumnOrderHint указывалось допустимое имя целевого столбца.

SqlException

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

Комментарии

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