DbCommand.ExecuteNonQueryAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 메서드는 비동기 버전을 ExecuteNonQuery()구현하지만 동기적으로 반환 Task 하여 호출 스레드를 차단합니다.
오버로드
| Name | Description |
|---|---|
| ExecuteNonQueryAsync(CancellationToken) |
이 버전은 .의 비동기 버전입니다 ExecuteNonQuery(). 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다. 기본 구현은 동기 ExecuteNonQuery() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. throw ExecuteNonQuery() 된 예외는 반환된 작업 예외 속성을 통해 전달됩니다. 반환된 작업이 완료될 때까지 개체의 |
| ExecuteNonQueryAsync() |
해당 연결 개체에 대해 명령을 실행하여 영향을 받는 행 수를 반환하는 비동기 버전 ExecuteNonQuery()입니다. CancellationToken.None을 사용하여 호출합니다 ExecuteNonQueryAsync(CancellationToken) . |
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
ExecuteNonQueryAsync(CancellationToken)
이 버전은 .의 비동기 버전입니다 ExecuteNonQuery(). 공급자는 적절한 구현으로 재정의해야 합니다. 취소 토큰은 선택적으로 무시될 수 있습니다.
기본 구현은 동기 ExecuteNonQuery() 메서드를 호출하고 완료된 작업을 반환하여 호출 스레드를 차단합니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업을 반환합니다. throw ExecuteNonQuery() 된 예외는 반환된 작업 예외 속성을 통해 전달됩니다.
반환된 작업이 완료될 때까지 개체의 DbCommand 다른 메서드와 속성을 호출하지 마세요.
public:
virtual System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)매개 변수
- cancellationToken
- CancellationToken
비동기 작업을 취소하는 토큰입니다.
반품
비동기 작업을 나타내는 작업입니다.
예외
명령을 실행하는 동안 오류가 발생했습니다.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteNonQuery()throw된 예외를 참조하세요.
추가 정보
적용 대상
ExecuteNonQueryAsync()
해당 연결 개체에 대해 명령을 실행하여 영향을 받는 행 수를 반환하는 비동기 버전 ExecuteNonQuery()입니다.
CancellationToken.None을 사용하여 호출합니다 ExecuteNonQueryAsync(CancellationToken) .
public:
System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync();member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>Public Function ExecuteNonQueryAsync () As Task(Of Integer)반품
비동기 작업을 나타내는 작업입니다.
예외
명령을 실행하는 동안 오류가 발생했습니다.
설명
비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteNonQuery()throw된 예외를 참조하세요.