정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

WebClient 클래스

URI로 식별되는 리소스에 데이터를 보내고 이 리소스에서 데이터를 받기 위한 공용 메서드를 제공합니다.

네임스페이스: System.Net
어셈블리: System(system.dll)

[ComVisibleAttribute(true)] 
public class WebClient : Component
/** @attribute ComVisibleAttribute(true) */ 
public class WebClient extends Component
ComVisibleAttribute(true) 
public class WebClient extends Component

WebClient 클래스는 URI로 식별되는 로컬, 인트라넷 또는 인터넷 리소스에 데이터를 보내거나 여기에서 데이터를 받기 위한 공용 메서드를 제공합니다.

WebClient 클래스는 WebRequest 클래스를 사용하여 리소스에 액세스할 수 있도록 합니다. WebClient 인스턴스는 WebRequest.RegisterPrefix 메서드를 사용하여 등록된 WebRequest 하위 클래스를 사용하여 데이터에 액세스할 수 있습니다.

Note참고

기본적으로 .NET Framework는 http:, https:, ftp 및 file: 체계 식별자로 시작하는 URI를 지원합니다.

다음 표에서는 리소스에 데이터를 업로드하는 WebClient 메서드에 대해 설명합니다.

메서드

설명

OpenWrite

리소스에 데이터를 보내는 데 사용되는 Stream을 검색합니다.

OpenWriteAsync

호출 스레드를 차단하지 않으면서 리소스에 데이터를 보내는 데 사용되는 Stream을 검색합니다.

UploadData

리소스에 바이트 배열을 보내고 응답을 포함하는 Byte 배열을 반환합니다.

UploadDataAsync

호출 스레드를 차단하지 않으면서 리소스에 Byte 배열을 보냅니다.

UploadFile

리소스에 로컬 파일을 보내고 응답을 포함하는 Byte 배열을 반환합니다.

UploadFileAsync

호출 스레드를 차단하지 않으면서 리소스에 로컬 파일을 보냅니다.

UploadValues

리소스에 NameValueCollection을 보내고 응답을 포함하는 Byte 배열을 반환합니다.

UploadValuesAsync

호출 스레드를 차단하지 않으면서 리소스에 NameValueCollection을 보내고 응답을 포함하는 Byte 배열을 반환합니다.

UploadString

호출 스레드를 차단하지 않으면서 리소스에 String을 보냅니다.

UploadStringAsync

호출 스레드를 차단하지 않으면서 리소스에 String을 보냅니다.

다음 표에서는 리소스에서 데이터를 다운로드하는 WebClient 메서드에 대해 설명합니다.

메서드

설명

OpenRead

리소스에서 데이터를 Stream으로 반환합니다.

OpenReadAsync

호출 스레드를 차단하지 않으면서 리소스에서 데이터를 반환합니다.

DownloadData

리소스에서 데이터를 다운로드하고 Byte 배열을 반환합니다.

DownloadDataAsync

호출 스레드를 차단하지 않으면서 리소스에서 데이터를 다운로드하고 Byte 배열을 반환합니다.

DownloadFile

리소스에서 로컬 파일로 데이터를 다운로드합니다.

DownloadFileAsync

호출 스레드를 차단하지 않으면서 리소스에서 로컬 파일로 데이터를 다운로드합니다.

DownloadString

리소스에서 String을 다운로드하고 String을 반환합니다.

DownloadStringAsync

호출 스레드를 차단하지 않으면서 리소스에서 String을 다운로드합니다.

CancelAsync 메서드를 사용하여 완료되지 않은 비동기 작업을 취소할 수 있습니다.

WebClient 인스턴스는 기본적으로 선택적 HTTP 헤더를 보내지 않습니다. 요청에 선택적 헤더가 필요한 경우에는 헤더를 Headers 컬렉션에 추가해야 합니다. 예를 들어, 응답에 쿼리를 포함하려면 사용자 에이전트 헤더를 추가해야 합니다. 또한 사용자 에이전트 헤더가 없으면 서버에서 500(내부 서버 오류)을 반환할 수 있습니다.

WebClient에서는 AllowAutoRedirecttrue로 설정됩니다.

상속자 참고 사항 파생 클래스가 제대로 동작하려면 파생 클래스에서 기본 클래스에 구현된 WebClient를 호출해야 합니다.

다음 코드 예제에서는 리소스의 URI를 사용하여 리소스를 검색하고 응답을 표시합니다.

using System;
using System.Net;
using System.IO;

public class Test
{
    public static void Main (string[] args)
    {
        if (args == null || args.Length == 0)
        {
            throw new ApplicationException ("Specify the URI of the resource to retrieve.");
        }
        WebClient client = new WebClient ();

        // Add a user agent header in case the 
        // requested URI contains a query.

        client.Headers.Add ("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)");

        Stream data = client.OpenRead (args[0]);
        StreamReader reader = new StreamReader (data);
        string s = reader.ReadToEnd ();
        Console.WriteLine (s);
        data.Close ();
        reader.Close ();
    }
}

  • WebPermission  요청된 URI 또는 요청이 리디렉션되는 URI에 액세스하는 데 필요한 권한입니다. 연관된 열거형: Connect

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

.NET Framework

2.0, 1.1, 1.0에서 지원

커뮤니티 추가 항목

표시:
© 2014 Microsoft