SqlBulkCopy.WriteToServerAsync 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

데이터 소스의 모든 행을 WriteToServer 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.

오버로드

WriteToServerAsync(IDataReader, CancellationToken)	제공된 WriteToServer(IDataReader)의 모든 행을 IDataReader 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다. 취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
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의 비동기 버전입니다. 취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
WriteToServerAsync(DataTable, DataRowState)	제공된 WriteToServer(DataTable, DataRowState)에서 제공된 행 상태와 일치하는 행만을 DataTable 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.
WriteToServerAsync(DataTable, CancellationToken)	제공된 WriteToServer(DataTable)의 모든 행을 DataTable 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다. 취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	제공된 WriteToServer(DataTable, DataRowState)에서 제공된 행 상태와 일치하는 행만을 DataTable 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다. 취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

설명

MARS(활성 결과 집합)를 여러 개 사용하지 않도록 설정 WriteToServer 하면 연결이 사용 중입니다. MARS를 사용하는 경우 호출을 동일한 연결의 다른 명령과 인터리브할 WriteToServer 수 있습니다.

실패할 때 롤백되는 행의 수는 다음과 같은 몇 가지 사항에 따라 달라집니다.

• 가 UseInternalTransaction 지정되면 입니다.

• 사용자 고유의 트랜잭션이 있는 경우

• BatchSize의 값

서버에 데이터를 보내는 동안 오류가 발생하면 현재 일괄 처리(에 지정된 BatchSize대로)가 롤백됩니다. 가 지정되지 않고 사용자 고유의 트랜잭션이 있는 경우 UseInternalTransaction 전체 트랜잭션이 롤백됩니다(이전의 모든 일괄 처리도 포함).

를 사용하여 SqlRowsCopied 서버에 복사된 행 수를 알 수 있습니다.

WriteToServerAsync(IDataReader, CancellationToken)

제공된 WriteToServer(IDataReader)의 모든 행을 IDataReader 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(IDataReader)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(IDataReader) 및 WriteToServer(IDataReader)를 호출합니다.

WriteToServerAsync(IDataReader) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

완료된 IDataReader가 반환되기 전에 Task가 닫혔습니다.

완료된 IDataReader가 반환되기 전에 Task와 연결된 연결이 닫혔습니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

비동기 작업(operation)을 나타내는 작업(task)입니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataRow[])를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataRow[]) 및 WriteToServer(DataRow[])를 호출합니다.

WriteToServerAsync(DataRow[]) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable) 및 WriteToServer(DataTable)를 호출합니다.

WriteToServerAsync(DataTable) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(IDataReader)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(IDataReader) 및 WriteToServer(IDataReader)를 호출합니다.

WriteToServerAsync(IDataReader) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

완료된 IDataReader가 반환되기 전에 Task가 닫혔습니다.

완료된 IDataReader가 반환되기 전에 Task와 연결된 연결이 닫혔습니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw WriteToServer(DbDataReader)된 예외를 참조하세요.

WriteToServerAsync(DataRow[], CancellationToken)

제공된 WriteToServer(DataRow[]) 배열의 모든 행을 DataRow 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataRow[])를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataRow[]) 및 WriteToServer(DataRow[])를 호출합니다.

WriteToServerAsync(DataRow[]) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw 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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable, DataRowState)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable, DataRowState) 및 WriteToServer(DataTable, DataRowState)를 호출합니다.

WriteToServerAsync(DataTable, DataRowState) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw WriteToServer(DataTable, DataRowState)된 예외를 참조하세요.

WriteToServerAsync(DataTable, CancellationToken)

제공된 WriteToServer(DataTable)의 모든 행을 DataTable 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable) 및 WriteToServer(DataTable)를 호출합니다.

WriteToServerAsync(DataTable) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw WriteToServer(DataTable)된 예외를 참조하세요.

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

제공된 WriteToServer(DataTable, DataRowState)에서 제공된 행 상태와 일치하는 행만을 DataTable 개체의 DestinationTableName 속성에 지정된 대상 테이블로 복사하는 SqlBulkCopy의 비동기 버전입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

InvalidOperationException

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable, DataRowState)를 여러 번 호출합니다.

작업이 완료되기 전에 같은 인스턴스에 대해 WriteToServerAsync(DataTable, DataRowState) 및 WriteToServer(DataTable, DataRowState)를 호출합니다.

WriteToServerAsync(DataTable, DataRowState) 실행 중 연결이 끊기거나 닫힙니다.

작업 개체에서 반환되었으며, SqlBulkCopy 개체는 메서드를 실행하는 동안 닫혔습니다.

작업 개체에서 반환되었으며, 연결 풀 시간 제한이 있습니다.

작업 개체에서 반환되었으며, SqlConnection 개체는 메서드를 실행하기 전에 닫힙니다.

Context Connection=true는 연결 문자열에 지정됩니다.

SqlException

작업 개체에서 반환됩니다. 연결을 여는 동안 발생한 SQL Server에 의해 오류가 반환되었습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw WriteToServer(DataTable, DataRowState)된 예외를 참조하세요.