WebClient.CancelAsync 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.WebClient.dll

Source:

WebClient.cs

보류 중인 비동기 작업을 취소합니다.

public:
 void CancelAsync();

public void CancelAsync ();

member this.CancelAsync : unit -> unit

Public Sub CancelAsync ()

설명

주의

WebRequest, HttpWebRequest, ServicePoint및 WebClient 사용되지 않으므로 새 개발에 사용하면 안 됩니다. 대신 HttpClient 사용합니다.

작업이 보류 중인 경우 이 메서드는 기본 WebRequestAbort 호출합니다.

메모

.NET Core 2.0부터 CancelAsync 응답을 가져오기 시작한 경우 즉시 요청을 취소하지 않습니다. 최적의 취소 동작의 경우 WebClient대신 HttpClient 클래스를 사용합니다.

CancelAsync호출할 때 애플리케이션은 작업과 연결된 완료 이벤트를 계속 받습니다. 예를 들어 DownloadStringAsync 작업을 취소하기 위해 CancelAsync 호출할 때 DownloadStringCompleted 이벤트에 대한 이벤트 처리기를 지정한 경우 이벤트 처리기는 작업이 종료되었다는 알림을 받습니다. 작업이 성공적으로 완료되었는지 여부를 알아보려면 이벤트 처리기에 전달된 이벤트 데이터 개체에서 DownloadDataCompletedEventArgs 기본 클래스의 Cancelled 속성을 확인합니다.

비동기 작업이 진행 중이 아니면 이 메서드는 아무 작업도 수행하지 않습니다.