WebClient.OpenReadAsync 메서드

정의

지정된 리소스가 포함된 읽을 수 있는 스트림을 엽니다. 이들 메서드는 호출 스레드를 차단하지 않습니다.

오버로드

OpenReadAsync(Uri)

지정된 리소스가 포함된 읽을 수 있는 스트림을 엽니다. 이 메서드는 호출 스레드를 차단하지 않습니다.

OpenReadAsync(Uri, Object)

지정된 리소스가 포함된 읽을 수 있는 스트림을 엽니다. 이 메서드는 호출 스레드를 차단하지 않습니다.

OpenReadAsync(Uri)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

지정된 리소스가 포함된 읽을 수 있는 스트림을 엽니다. 이 메서드는 호출 스레드를 차단하지 않습니다.

public:
 void OpenReadAsync(Uri ^ address);
public void OpenReadAsync (Uri address);
member this.OpenReadAsync : Uri -> unit
Public Sub OpenReadAsync (address As Uri)

매개 변수

address
Uri

검색할 리소스의 URI입니다.

예외

address 매개 변수가 null인 경우

BaseAddress와 주소를 조합하여 만든 URI가 잘못된 경우

또는

리소스를 다운로드하는 동안 오류가 발생한 경우

또는

스트림을 여는 동안 오류가 발생한 경우

설명

이 메서드는 매개 변수로 Stream 지정된 리소스에 액세스하는 데 사용되는 instance 검색합니다address. 스트림은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 가져옵니다. 스트림을 사용할 수 있을 때 알림을 받으려면 이벤트에 이벤트 처리기를 추가합니다 OpenReadCompleted .

참고

시스템 리소스가 부족하지 않도록 를 완료 Stream 하면 를 호출 Stream.Close 해야 합니다.

이 메서드는 스트림이 열리는 동안 호출 스레드를 차단하지 않습니다. 스트림을 기다리는 동안 차단하려면 메서드를 OpenReadAsync 사용합니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI address 를 지정하지 않는 경우 는 요청된 리소스의 절대 URI를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 이 QueryString 아니면 null에 추가됩니다 address.

이 메서드는 RETR 명령을 사용하여 FTP 리소스를 다운로드합니다. HTTP 리소스의 경우 GET 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

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

적용 대상

OpenReadAsync(Uri, Object)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

지정된 리소스가 포함된 읽을 수 있는 스트림을 엽니다. 이 메서드는 호출 스레드를 차단하지 않습니다.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);
public void OpenReadAsync (Uri address, object? userToken);
public void OpenReadAsync (Uri address, object userToken);
member this.OpenReadAsync : Uri * obj -> unit
Public Sub OpenReadAsync (address As Uri, userToken As Object)

매개 변수

address
Uri

검색할 리소스의 URI입니다.

userToken
Object

비동기 작업이 완료될 때 호출되는 메서드로 전달되는 사용자 정의 개체입니다.

예외

address 매개 변수가 null인 경우

BaseAddress와 주소를 조합하여 만든 URI가 잘못된 경우

또는

리소스를 다운로드하는 동안 오류가 발생한 경우

또는

스트림을 여는 동안 오류가 발생한 경우

설명

이 메서드는 매개 변수로 Stream 지정된 리소스에 액세스하는 데 사용되는 instance 검색합니다address. 스트림은 스레드 풀에서 자동으로 할당되는 스레드 리소스를 사용하여 가져옵니다. 스트림을 사용할 수 있을 때 알림을 받으려면 이벤트에 이벤트 처리기를 추가합니다 OpenReadCompleted .

참고

시스템 리소스가 부족하지 않도록 를 완료 Stream 하면 를 호출 Stream.Close 해야 합니다.

이 메서드는 스트림이 열리는 동안 호출 스레드를 차단하지 않습니다. 스트림을 기다리는 동안 차단하려면 메서드를 OpenRead 사용합니다.

.NET Framework 및 .NET Core 1.0에서는 메서드를 호출 CancelAsync 하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

속성이 BaseAddress 빈 문자열("")이 아니고 address 절대 URI address 를 지정하지 않는 경우 는 요청된 리소스의 절대 URI를 형성하기 위해 와 BaseAddress 결합된 상대 URI여야 합니다. 속성이 이 QueryString 아니면 null에 추가됩니다 address.

이 메서드는 RETR 명령을 사용하여 FTP 리소스를 다운로드합니다. HTTP 리소스의 경우 GET 메서드가 사용됩니다.

참고

애플리케이션에 네트워크 추적을 사용하도록 설정하면 이 멤버에서 추적 정보를 출력합니다. 자세한 내용은 .NET Framework 네트워크 추적을 참조하세요.

적용 대상