HttpWebRequest 클래스
TOC
콘텐츠의 테이블 축소
콘텐츠의 테이블 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

HttpWebRequest 클래스

 

WebRequest 클래스의 HTTP 관련 구현을 제공합니다.

네임스페이스:   System.Net
어셈블리:  System.dll의 System


[SerializableAttribute]
public class HttpWebRequest : WebRequest, ISerializable

이름설명
System_CAPS_pubmethodHttpWebRequest()

사용되지 않습니다. 유니 코드 문자의 배열을 가리키는 포인터가 나타내는 값으로, String 클래스의 새로운 인스턴스를 초기화 합니다.

System_CAPS_protmethodHttpWebRequest(SerializationInfo, StreamingContext)

사용되지 않습니다. 유니 코드 문자의 배열을 가리키는 포인터가 나타내는 값으로, String 클래스의 새로운 인스턴스를 초기화 합니다.

이름설명
System_CAPS_pubpropertyAccept

Accept HTTP 헤더의 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyAddress

요청에 실제로 응답하는 인터넷 리소스의 URI(Uniform Resource Identifier)를 가져옵니다.

System_CAPS_pubpropertyAllowAutoRedirect

요청이 리디렉션 응답을 따르는지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyAllowReadStreamBuffering

인터넷 리소스에서 받은 데이터를 버퍼링할지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyAllowWriteStreamBuffering

인터넷 리소스에 보낸 데이터를 버퍼링할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyAuthenticationLevel

이 요청에 사용되는 인증 및 가장 수준을 나타내는 값을 가져오거나 설정합니다.(WebRequest에서 상속됨.)

System_CAPS_pubpropertyAutomaticDecompression

압축을 푸는 데 사용할 형식을 가져오거나 설정합니다.

System_CAPS_pubpropertyCachePolicy

이 요청에 대한 캐시 정책을 가져오거나 설정합니다.(WebRequest에서 상속됨.)

System_CAPS_pubpropertyClientCertificates

이 요청과 관련된 보안 인증서의 컬렉션을 가져오거나 설정합니다.

System_CAPS_pubpropertyConnection

Connection HTTP 헤더의 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyConnectionGroupName

요청에 대한 연결 그룹의 이름을 가져오거나 설정합니다.(WebRequest.ConnectionGroupName을(를) 재정의함)

System_CAPS_pubpropertyContentLength

Content-length HTTP 헤더를 가져오거나 설정합니다.(WebRequest.ContentLength을(를) 재정의함)

System_CAPS_pubpropertyContentType

Content-type HTTP 헤더의 값을 가져오거나 설정합니다.(WebRequest.ContentType을(를) 재정의함)

System_CAPS_pubpropertyContinueDelegate

Gets or sets the delegate method called when an HTTP 100-continue response is received from the Internet resource.

System_CAPS_pubpropertyContinueTimeout

서버에서 100-Continue가 수신될 때까지 기다릴 제한 시간(밀리초)을 가져오거나 설정합니다.

System_CAPS_pubpropertyCookieContainer

이 요청과 관련된 쿠키를 가져오거나 설정합니다.

System_CAPS_pubpropertyCreatorInstance

사용되지 않습니다.하위 클래스에서 재정의될 때, 지정된 URI 에 요청하기 위해 인스턴스화된 WebRequest를 만드는 데 사용되는 IWebRequestCreate 클래스에서 파생된 팩터리 개체를 가져옵니다.(WebRequest에서 상속됨.)

System_CAPS_pubpropertyCredentials

요청에 대한 인증 정보를 가져오거나 설정합니다.(WebRequest.Credentials을(를) 재정의함)

System_CAPS_pubpropertyDate

HTTP 요청에 사용할 Date HTTP 헤더 값을 가져오거나 설정합니다.

System_CAPS_pubpropertySystem_CAPS_staticDefaultCachePolicy

이 요청에 대한 기본 캐시 정책을 가져오거나 설정합니다.

System_CAPS_pubpropertySystem_CAPS_staticDefaultMaximumErrorResponseLength

HTTP 오류 응답의 기본 최대 길이를 가져오거나 설정합니다.

System_CAPS_pubpropertySystem_CAPS_staticDefaultMaximumResponseHeadersLength

Gets or sets the default for the MaximumResponseHeadersLength property.

System_CAPS_pubpropertyExpect

Expect HTTP 헤더의 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyHaveResponse

Gets a value that indicates whether a response has been received from an Internet resource.

System_CAPS_pubpropertyHeaders

HTTP 헤더를 구성하는 이름/값 쌍의 컬렉션을 지정합니다.(WebRequest.Headers을(를) 재정의함)

System_CAPS_pubpropertyHost

요청 URI와 독립적인 HTTP 요청에 사용할 Host 헤더 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyIfModifiedSince

If-Modified-Since HTTP 헤더의 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyImpersonationLevel

현재 요청에 대한 가장 수준을 가져오거나 설정합니다.(WebRequest에서 상속됨.)

System_CAPS_pubpropertyKeepAlive

Gets or sets a value that indicates whether to make a persistent connection to the Internet resource.

System_CAPS_pubpropertyMaximumAutomaticRedirections

요청이 따르는 최대 리디렉션 수를 가져오거나 설정합니다.

System_CAPS_pubpropertyMaximumResponseHeadersLength

응답 헤더의 허용되는 최대 길이를 가져오거나 설정합니다.

System_CAPS_pubpropertyMediaType

요청의 미디어 형식을 가져오거나 설정합니다.

System_CAPS_pubpropertyMethod

요청에 대한 메서드를 가져오거나 설정합니다.(WebRequest.Method을(를) 재정의함)

System_CAPS_pubpropertyPipelined

요청을 인터넷 리소스에 파이프라인할 것인지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyPreAuthenticate

요청과 함께 인증 헤더를 보낼 것인지 여부를 나타내는 값을 가져오거나 설정합니다.(WebRequest.PreAuthenticate을(를) 재정의함)

System_CAPS_pubpropertyProtocolVersion

요청에 사용할 HTTP의 버전을 가져오거나 설정합니다.

System_CAPS_pubpropertyProxy

요청에 대한 프록시 정보를 가져오거나 설정합니다.(WebRequest.Proxy을(를) 재정의함)

System_CAPS_pubpropertyReadWriteTimeout

스트림에 쓰거나 스트림에서 읽을 때의 제한 시간을 밀리초 단위로 가져오거나 설정합니다.

System_CAPS_pubpropertyReferer

Gets or sets the value of the Referer HTTP header.

System_CAPS_pubpropertyRequestUri

요청의 원래 URI(Uniform Resource Identifier)를 가져옵니다.(WebRequest.RequestUri을(를) 재정의함)

System_CAPS_pubpropertySendChunked

인터넷 리소스에 데이터를 분할된 형태로 보낼 것인지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyServerCertificateValidationCallback

서버 인증서의 유효성을 검사할 콜백 함수를 가져오거나 설정합니다.

System_CAPS_pubpropertyServicePoint

요청에 사용할 서비스 지점을 가져옵니다.

System_CAPS_pubpropertySupportsCookieContainer

요청이 CookieContainer를 지원하는지 여부를 나타내는 값을 가져옵니다.

System_CAPS_pubpropertyTimeout

GetResponseGetRequestStream 메서드의 제한 시간 값을 밀리초 단위로 가져오거나 설정합니다.(WebRequest.Timeout을(를) 재정의함)

System_CAPS_pubpropertyTransferEncoding

Gets or sets the value of the Transfer-encoding HTTP header.

System_CAPS_pubpropertyUnsafeAuthenticatedConnectionSharing

고속 NTLM 인증 연결 공유가 허용되는지 여부를 나타내는 값을 가져오거나 설정합니다.

System_CAPS_pubpropertyUseDefaultCredentials

기본 자격 증명을 요청과 함께 보내는지 여부를 제어하는 Boolean 값을 가져오거나 설정합니다.(WebRequest.UseDefaultCredentials을(를) 재정의함)

System_CAPS_pubpropertyUserAgent

User-agent HTTP 헤더의 값을 가져오거나 설정합니다.

이름설명
System_CAPS_pubmethodAbort()

인터넷 리소스에 대한 요청을 취소합니다.(WebRequest.Abort()을(를) 재정의함)

System_CAPS_pubmethodAddRange(Int32)

요청된 데이터의 시작이나 끝에서 특정 범위에 대해 바이트 범위 헤더를 요청에 추가합니다.

System_CAPS_pubmethodAddRange(Int32, Int32)

지정된 범위에 대해 요청에 바이트 범위 헤더를 추가합니다.

System_CAPS_pubmethodAddRange(Int64)

요청된 데이터의 시작이나 끝에서 특정 범위에 대해 바이트 범위 헤더를 요청에 추가합니다.

System_CAPS_pubmethodAddRange(Int64, Int64)

지정된 범위에 대해 요청에 바이트 범위 헤더를 추가합니다.

System_CAPS_pubmethodAddRange(String, Int32)

요청된 데이터의 시작이나 끝에서 특정 범위에 대한 요청에 Range 헤더를 추가합니다.

System_CAPS_pubmethodAddRange(String, Int32, Int32)

Adds a range header to a request for a specified range.

System_CAPS_pubmethodAddRange(String, Int64)

요청된 데이터의 시작이나 끝에서 특정 범위에 대한 요청에 Range 헤더를 추가합니다.

System_CAPS_pubmethodAddRange(String, Int64, Int64)

지정된 범위에 대해 요청에 범위 헤더를 추가합니다.

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

데이터를 쓰는 데 사용할 Stream 개체에 대한 비동기 요청을 시작합니다.(WebRequest.BeginGetRequestStream(AsyncCallback, Object)을(를) 재정의함)

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

인터넷 리소스에 대한 비동기 요청을 시작합니다.(WebRequest.BeginGetResponse(AsyncCallback, Object)을(를) 재정의함)

System_CAPS_pubmethodCreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.(MarshalByRefObject에서 상속됨.)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

데이터를 쓰는 데 사용할 Stream 개체에 대한 비동기 요청을 끝냅니다.(WebRequest.EndGetRequestStream(IAsyncResult)을(를) 재정의함)

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult, TransportContext)

데이터를 쓰는 데 사용하는 Stream 개체에 대한 비동기 요청을 종료하고 해당 스트림과 연결된 TransportContext를 출력합니다.

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

Ends an asynchronous request to an Internet resource.(WebRequest.EndGetResponse(IAsyncResult)을(를) 재정의함)

System_CAPS_pubmethodEquals(Object)

지정한 개체가 현재 개체와 같은지 여부를 확인합니다. (Object에서 상속됨.)

System_CAPS_protmethodFinalize()

개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨.)

System_CAPS_pubmethodGetHashCode()

기본 해시 함수로 작동합니다. (Object에서 상속됨.)

System_CAPS_pubmethodGetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.(MarshalByRefObject에서 상속됨.)

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

이 API는 제품 인프라를 지원하지만 코드에서 직접 사용할 수는 없습니다. 대상 개체를 serialize하는 데 필요한 데이터로 SerializationInfo를 채웁니다.(WebRequest.GetObjectData(SerializationInfo, StreamingContext)을(를) 재정의함)

System_CAPS_pubmethodGetRequestStream()

요청 데이터를 쓰는 데 사용할 Stream 개체를 가져옵니다.(WebRequest.GetRequestStream()을(를) 재정의함)

System_CAPS_pubmethodGetRequestStream(TransportContext)

요청 데이터를 쓰는 데 사용하는 Stream 개체를 가져오고 해당 스트림과 연결된 TransportContext를 출력합니다.

System_CAPS_pubmethodGetRequestStreamAsync()

서브클래스에서 재정의될 때, 인터넷 리소스에 비동기 작업으로 데이터를 쓰기 위해 Stream을 반환합니다.(WebRequest에서 상속됨.)

System_CAPS_pubmethodGetResponse()

Returns a response from an Internet resource.(WebRequest.GetResponse()을(를) 재정의함)

System_CAPS_pubmethodGetResponseAsync()

하위 항목 클래스에 재정의될 때, 인터넷 요청에 대한 응답을 비동기 작업으로 반환합니다.(WebRequest에서 상속됨.)

System_CAPS_pubmethodGetType()

현재 인스턴스의 Type을 가져옵니다.(Object에서 상속됨.)

System_CAPS_pubmethodInitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하기 위한 수명 서비스 개체를 가져옵니다.(MarshalByRefObject에서 상속됨.)

System_CAPS_protmethodMemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.(Object에서 상속됨.)

System_CAPS_protmethodMemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.(MarshalByRefObject에서 상속됨.)

System_CAPS_pubmethodToString()

현재 개체를 나타내는 문자열을 반환합니다.(Object에서 상속됨.)

이름설명
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

이 API는 제품 인프라를 지원하지만 코드에서 직접 사용할 수는 없습니다. 대상 개체를 직렬화하는 데 필요한 데이터로 SerializationInfo를 채웁니다.

The T:System.Net.HttpWebRequest class provides support for the properties and methods defined in T:System.Net.WebRequest and for additional properties and methods that enable the user to interact directly with servers using HTTP.

Do not use the M:System.Net.HttpWebRequest.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext) constructor. Use the Overload:System.Net.WebRequest.Create method to initialize new T:System.Net.HttpWebRequest objects. If the scheme for the Uniform Resource Identifier (URI) is http:// or https://, Overload:System.Net.WebRequest.Create returns an T:System.Net.HttpWebRequest object.

The M:System.Net.HttpWebRequest.GetResponse method makes a synchronous request to the resource specified in the P:System.Net.HttpWebRequest.RequestUri property and returns an T:System.Net.HttpWebResponse that contains the response. You can make an asynchronous request to the resource using the M:System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object) and M:System.Net.HttpWebRequest.EndGetResponse(System.IAsyncResult) methods.

When you want to send data to the resource, the M:System.Net.HttpWebRequest.GetRequestStream method returns a T:System.IO.Stream object to use to send data. The M:System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object) and M:System.Net.HttpWebRequest.EndGetRequestStream(System.IAsyncResult) methods provide asynchronous access to the send data stream.

For client authentication with T:System.Net.HttpWebRequest, the client certificate must be installed in the My certificate store of the current user.

The T:System.Net.HttpWebRequest class throws a T:System.Net.WebException when errors occur while accessing a resource. The P:System.Net.WebException.Status property contains a T:System.Net.WebExceptionStatus value that indicates the source of the error. When P:System.Net.WebException.Status is F:System.Net.WebExceptionStatus.ProtocolError, the P:System.Net.WebException.Response property contains the T:System.Net.HttpWebResponse received from the resource.

HttpWebRequest exposes common HTTP header values sent to the Internet resource as properties, set by methods, or set by the system; the following table contains a complete list. You can set other headers in the Headers property as name/value pairs. Note that servers and caches may change or add headers during the request.

The following table lists the HTTP headers that are set either by properties or methods or the system.

Header

Set by

Accept

Set by the P:System.Net.HttpWebRequest.Accept property.

Connection

Set by the P:System.Net.HttpWebRequest.Connection property, P:System.Net.HttpWebRequest.KeepAlive property.

Content-Length

Set by the P:System.Net.HttpWebRequest.ContentLength property.

Content-Type

Set by the P:System.Net.HttpWebRequest.ContentType property.

Expect

Set by the P:System.Net.HttpWebRequest.Expect property.

Date

Set by the system to current date.

Host

Set by the system to current host information.

If-Modified-Since

Set by the P:System.Net.HttpWebRequest.IfModifiedSince property.

Range

Set by the M:System.Net.HttpWebRequest.AddRange(System.Int32,System.Int32) method.

Referer

Set by the P:System.Net.HttpWebRequest.Referer property.

Transfer-Encoding

Set by the P:System.Net.HttpWebRequest.TransferEncoding property (the P:System.Net.HttpWebRequest.SendChunked property must be true).

User-Agent

Set by the P:System.Net.HttpWebRequest.UserAgent property.

System_CAPS_note참고

HttpWebRequest is registered automatically. You do not need to call the RegisterPrefix method to register System.Net.HttpWebRequest before using URIs beginning with http:// or https://.

The local computer or application config file may specify that a default proxy be used. If the P:System.Net.HttpWebRequest.Proxy property is specified, then the proxy settings from the P:System.Net.HttpWebRequest.Proxy property override the local computer or application config file and the T:System.Net.HttpWebRequest instance will use the proxy settings specified. If no proxy is specified in a config file and the P:System.Net.HttpWebRequest.Proxy property is unspecified, the T:System.Net.HttpWebRequest class uses the proxy settings inherited from Internet Explorer on the local computer. If there are no proxy settings in Internet Explorer, the request is sent directly to the server.

The T:System.Net.HttpWebRequest class parses a proxy bypass list with wildcard characters inherited from Internet Explorer differently than the bypass list is parsed directly by Internet Explorer. For example, the T:System.Net.HttpWebRequest class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.$". This differs from the native behavior of Internet Explorer. So a URL of "http://intxxxxx" would bypass the proxy using the T:System.Net.HttpWebRequest class, but would not bypass the proxy using Internet Explorer.

System_CAPS_note참고

The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. When attempting to reuse an SSL session, the Framework uses the first element of P:System.Net.HttpWebRequest.ClientCertificates (if there is one), or tries to reuse an anonymous sessions if P:System.Net.HttpWebRequest.ClientCertificates is empty.

System_CAPS_note참고

For security reasons, cookies are disabled by default. If you want to use cookies, use the P:System.Net.HttpWebRequest.CookieContainer property to enable cookies.

The following code example creates an T:System.Net.HttpWebRequest for the URI http://www.contoso.com/.


HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

WebPermission

to access the requested URI or any URI that the request is redirected to. Associated enumeration: F:System.Net.NetworkAccess.Connect

Universal Windows Platform
4.5 이후에 사용 가능
.NET Framework
1.1 이후에 사용 가능
Portable Class Library
portable .NET platforms에서 지원 portable .NET platforms
Silverlight
2.0 이후에 사용 가능
Windows Phone Silverlight
7.0 이후에 사용 가능
Windows Phone
8.1 이후에 사용 가능

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

맨 위로 이동
표시:
© 2016 Microsoft