WebRequest 클래스

2013-12-13

URI(Uniform Resource Identifier)에 대한 요청을 만듭니다. 이것은 abstract 클래스입니다.

Namespace:  System.Net
어셈블리:  System.Net(System.Net.dll)

public abstract class WebRequest

WebRequest 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Protected 메서드WebRequestWebRequest 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성ContentLength서브클래스에서 재정의된 경우 전송 중인 요청 데이터의 콘텐츠 길이를 가져오거나 설정합니다.
Public 속성ContentType서브클래스에서 재정의된 경우 전송 중인 요청 데이터의 콘텐츠 형식을 가져오거나 설정합니다.
Public 속성CreatorInstance하위 클래스에서 재정의될 때, 지정된 URI 에 요청하기 위해 인스턴스화된 WebRequest를 만드는 데 사용되는 IWebRequestCreate 클래스에서 파생된 팩터리 개체를 가져옵니다.
Public 속성Credentials서브클래스에서 재정의된 경우 인터넷 리소스를 사용하여 요청을 인증하는 데 사용되는 네트워크 자격 증명을 가져오거나 설정합니다.
Public 속성Headers서브클래스에서 재정의된 경우 요청과 연결된 헤더 이름/값 쌍의 컬렉션을 가져오거나 설정합니다.
Public 속성Method서브클래스에서 재정의된 경우 이 요청에서 사용할 프로토콜 메서드를 가져오거나 설정합니다.
Public 속성RequestUri서브클래스에서 재정의된 경우 요청과 연결된 인터넷 리소스의 URI를 가져옵니다.
Public 속성UseDefaultCredentials서브클래스에서 재정의되는 경우 기본 자격 증명을 요청과 함께 보낼지 여부를 제어하는 Boolean 값을 가져오거나 설정합니다.
맨 위

  이름설명
Public 메서드Abort요청을 중단합니다.
Public 메서드BeginGetRequestStream서브클래스에서 재정의된 경우 스트림을 요청하는 비동기 메서드를 제공합니다.
Public 메서드BeginGetResponse서브클래스에서 재정의된 경우 인터넷 리소스에 대한 비동기 요청을 시작합니다.
Public 메서드정적 멤버Create(String)지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.
Public 메서드정적 멤버Create(Uri)지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.
Public 메서드정적 멤버CreateHttp(String)지정된 URI 문자열에 대한 새 HttpWebRequest 인스턴스를 초기화합니다.
Public 메서드정적 멤버CreateHttp(Uri)지정된 URI에 대한 새 HttpWebRequest 인스턴스를 초기화합니다.
Public 메서드EndGetRequestStream서브클래스에서 재정의될 때, 인터넷 리소스에 데이터를 쓰기 위해 Stream을 반환합니다.
Public 메서드EndGetResponse파생 클래스에서 재정의될 때, WebResponse를 반환합니다.
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드정적 멤버RegisterPrefix지정된 URI에 대한 WebRequest 하위 항목을 등록합니다.
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
맨 위

  이름설명
Public 확장 메서드GetCurrentNetworkInterface웹 요청에 해당하는 네트워크 인터페이스에 대한 사용 가능한 모든 정보를 가져옵니다. (WebRequestExtensions에서 정의됨)
Public 확장 메서드SetNetworkPreference통신망 기술 또는 비통신망 기술을 사용하여 웹 요청의 기본 설정을 구성합니다. (WebRequestExtensions에서 정의됨)
Public 확장 메서드SetNetworkRequirement통신망 기술 또는 비통신망 기술을 사용하여 웹 요청의 요구 사항을 구성합니다. (WebRequestExtensions에서 정의됨)
맨 위

WebRequest는 인터넷에서 데이터에 액세스하기 위한 .NET Framework의 요청/응답 모델에 대한 abstract 기본 클래스입니다. 요청/응답 모델을 사용하는 응용프로그램은 프로토콜을 알 수 없는 방식으로 인터넷에서 데이터를 요청할 수 있고, 응용프로그램은 특정 프로토콜의 서브클래스가 세부적인 요청을 수행하는 동안 WebRequest 클래스의 인스턴스를 사용하여 같은 방식으로 작업합니다.

서버에 있는 웹 페이지와 마찬가지로, 요청이 응용프로그램에서 특정 URI로 보내집니다. URI는 응용프로그램에 대해 등록한 WebRequest 하위 항목의 목록에서 만들 고유한 서브클래스를 결정합니다. WebRequest 하위 항목은 일반적으로 HTTP나 HTTPS와 마찬가지로 특정 프로토콜을 처리하기 위해 등록하지만, 특정 서버에 대한 요청이나 서버에 있는 경로를 처리하기 위해 등록할 수도 있습니다.

WebRequest 클래스는 인터넷 리소스에 액세스하는 동안 오류가 발생할 경우 WebException을 발생합니다. Status 속성은 오류의 소스를 나타내는 WebExceptionStatus 값 중의 하나입니다.

StatusUnknownError인 경우 Response 속성을 사용하여 프로토콜별 응답 오류에 대한 추가 정보를 볼 수 있습니다. Response 속성이 null이 아니면 원격 서버에서 오류 코드로 응답했음을 나타냅니다. 이 경우에는 Response 속성을 대상으로 응답에 대한 자세한 내용을 쿼리할 수 있습니다.

WebRequest 클래스는 abstract 클래스이므로 런타임에 WebRequest 인스턴스의 실제 동작은 Create 메서드에서 반환된 서브클래스에 따라 결정됩니다. 기본값 및 예외에 대한 자세한 내용은 HttpWebRequest와 같은 서브클래스에 대한 설명서를 참조하세요.

참고참고:

WebRequest 인스턴스를 초기화하려면 Create 메서드를 사용합니다. WebRequest 생성자를 사용하지 마세요.

기능

앱에서 이 API를 사용하는 경우 앱 매니페스트에서 다음 기능을 지정해야 합니다. 그렇지 않으면 앱이 올바르게 작동하지 않거나 예기치 않게 종료될 수 있습니다.

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

자세한 내용은 Windows Phone의 앱 기능 및 하드웨어 요구 사항을 참조하세요.

상속자 참고 사항

WebRequest에서 상속하는 경우 다음 멤버를 재정의해야 합니다. Method, RequestUri, Headers, ContentType, Credentials, Abort, BeginGetRequestStream, EndGetRequestStream, BeginGetResponse, and EndGetResponse. 또한 Create를 호출할 때 사용되는 Create 메서드를 정의하는 IWebRequestCreate 인터페이스의 구현을 제공해야 합니다. RegisterPrefix 메서드를 사용하여 IWebRequestCreate 인터페이스를 구현하는 클래스도 등록해야 합니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

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

표시:
© 2014 Microsoft