.net WebRequest 클래스

.dtTABLE {border:1px;}


WebRequest 클래스

 

URI(Uniform Resource Identifier)에 요청합니다. 추상(Visual Basic의 MustInherit) 클래스입니다.

이 형식의 전체 멤버 목록을 보려면 WebRequest 멤버을(를) 참조하십시오.

System.Object
   System.MarshalByRefObject
      System.Net.WebRequest
         System.Net.FileWebRequest
         System.Net.HttpWebRequest

[Visual Basic]
<Serializable>
MustInherit Public Class WebRequest
   Inherits MarshalByRefObject
   Implements ISerializable

[C#]
[Serializable]
public abstract class WebRequest : MarshalByRefObject,
   ISerializable

[C++]
[Serializable]
public __gc __abstract class WebRequest : public
   MarshalByRefObject, ISerializable

[JScript]
public
   Serializable
abstract class WebRequest extends MarshalByRefObject
   implements ISerializable

스레드로부터 안전한 방식

serialization을 사용할 때에는 완전히 신뢰되는 모드에서 응용 프로그램을 실행해야 합니다.

설명

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

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

WebRequest 클래스는 인터넷 리소스에 액세스하는 동안 오류가 발생할 경우 WebException를 throw합니다. WebException.Status 속성은 오류의 소스를 나타내는 WebExceptionStatus 값 중의 하나입니다. WebException.Status가 WebExceptionStatus.ProtocolError인 경우, Response 속성에는 인터넷 리소스에서 받은 WebResponse가 들어 있습니다.

WebRequest 클래스가 추상(Visual Basic의 MustInherit) 클래스이기 때문에, 런타임에서 WebRequest 인스턴스의 실제 동작은 WebRequest.Create 메서드가 반환한 하위 클래스에 의해 결정됩니다. 기본값과 예외에 대한 자세한 정보는 HttpWebRequest 나 FileWebRequest와 같은 하위 클래스에 대한 설명서를 참조하십시오.

참고    Create 메서드를 사용하여 WebRequest의 새 인스턴스를 초기화합니다. WebRequest 생성자를 사용하지 마십시오.

상속자에 대한 참고 사항:   WebRequest에서 상속하는 경우, Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream, BeginGetRequestStream, EndGetRequestStream, GetResponse, BeginGetResponse 및 EndGetResponse 멤버를 재정의해야 합니다. 또한 Create를 호출할 때 사용되는 Create 메서드를 정의하는 IWebRequestCreate 인터페이스의 구현을 제공해야 합니다. RegisterPrefix 메서드나 구성 파일을 사용하여 IWebRequestCreate 인터페이스를 구현하는 클래스도 등록해야 합니다.

예제

[Visual Basic, C#] 다음 예제는 WebRequest 인스턴스를 만들고 응답을 반환하는 방법을 보여 줍니다.

[Visual Basic] 
' Initialize the WebRequest.
Dim myRequest As WebRequest = WebRequest.Create("http://www.contoso.com")

' Return the response. 
Dim myResponse As WebResponse = myRequest.GetResponse()

' Code to use the WebResponse goes here.
' Close the response to free resources.
myResponse.Close()

[C#] 
// Initialize the WebRequest.
WebRequest myRequest = WebRequest.Create("http://www.contoso.com");

// Return the response. 
WebResponse myResponse = myRequest.GetResponse();

// Code to use the WebResponse goes here.

// Close the response to free resources.
myResponse.Close();

[C++, JScript] C++ 또는 JScript에 사용할 수 있는 예제가 없습니다. Visual Basic 또는 C# 예제를 보려면 이 페이지의 왼쪽 위에 있는 언어 필터 단추 언어 필터를 클릭하십시오.

요구 사항

네임스페이스: System.Net

플랫폼: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Sever 2003 제품군, .NET Compact Framework - Windows CE .NET

어셈블리: System (System.dll)

.NET Framework 보안: 

  • WebPermission - 요청된 URI 또는 요청이 리디렉션된 URI에 액세스합니다. 연관된 열거형: Connect


WebRequest 개요

Public 속성

public 속성ConnectionGroupName

.NET Compact Framework에서 지원

파생 클래스에서 재정의될 때 요청에 대한 연결 그룹 이름을 가져오거나 설정합니다.
public 속성ContentLength

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 전송 중인 요청 데이터의 내용 길이를 가져오거나 설정합니다.
public 속성ContentType

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 전송 중인 요청 데이터의 내용 형식을 가져오거나 설정합니다.
public 속성Credentials

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 인터넷 리소스를 사용하여 요청을 인증하는 데 사용되는 네트워크 자격 증명을 가져오거나 설정합니다.
public 속성Headers

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 요청과 연결된 헤더 이름/값 쌍의 컬렉션을 가져오거나 설정합니다.
public 속성Method

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 이 요청에서 사용할 프로토콜 메서드를 가져오거나 설정합니다.
public 속성PreAuthenticate

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 요청을 미리 인증할지 여부를 나타냅니다.
public 속성Proxy

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 이 인터넷 리소스에 액세스하기 위해 사용할 네트워크 프록시를 가져오거나 설정합니다.
public 속성RequestUri

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 요청과 연결된 인터넷 리소스의 URI를 가져옵니다.
public 속성Timeout

.NET Compact Framework에서 지원

요청이 시간 제한으로 실패하기 전에 시간의 길이를 가져오거나 설정합니다.

Public 메서드

public 메서드Abort

.NET Compact Framework에서 지원

인터넷 리소스에 대한 비동기 요청을 취소합니다.
public 메서드BeginGetRequestStream

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, GetRequestStream 메서드의 비동기 버전을 제공합니다.
public 메서드BeginGetResponse

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 인터넷 리소스에 대한 비동기 요청을 시작합니다.
public 메서드static (Shared in Visual Basic)Create

.NET Compact Framework에서 지원

오버로드되었습니다. 새 WebRequest를 초기화합니다.
public 메서드static (Shared in Visual Basic)CreateDefault

.NET Compact Framework에서 지원

지정된 URI 스키마에 대한 새 WebRequest 인스턴스를 초기화합니다.
public 메서드CreateObjRef(MarshalByRefObject에서 상속) 원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.
public 메서드EndGetRequestStream

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 인터넷 리소스에 데이터를 쓰기 위해 Stream을 반환합니다.
public 메서드EndGetResponse

.NET Compact Framework에서 지원

파생 클래스에서 재정의될 때, WebResponse를 반환합니다.
public 메서드Equals(Object에서 상속)

.NET Compact Framework에서 지원

오버로드되었습니다. 두 개의 Object 인스턴스가 같은지 여부를 확인합니다.
public 메서드GetHashCode(Object에서 상속)

.NET Compact Framework에서 지원

특정 형식에 대한 해시 함수로 사용되며 해시 알고리즘 및 해시 테이블과 같은 데이터 구조에 사용하기 적당합니다.
public 메서드GetLifetimeService(MarshalByRefObject에서 상속) 이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.
public 메서드GetRequestStream

.NET Compact Framework에서 지원

하위 클래스에서 재정의될 때, 인터넷 리소스에 데이터를 쓰기 위해 Stream을 반환합니다.
public 메서드GetResponse

.NET Compact Framework에서 지원

하위 클래스에 재정의될 때, 인터넷 요청에 대한 응답을 반환합니다.
public 메서드GetType(Object에서 상속)

.NET Compact Framework에서 지원

현재 인스턴스의 Type을 가져옵니다.
public 메서드InitializeLifetimeService(MarshalByRefObject에서 상속) 이 인스턴스의 수명 정책을 제어하기 위한 수명 서비스 개체를 가져옵니다.
public 메서드static (Shared in Visual Basic)RegisterPrefix

.NET Compact Framework에서 지원

지정된 URI에 대한 WebRequest 하위 항목을 등록합니다.
public 메서드ToString(Object에서 상속)

.NET Compact Framework에서 지원

현재 Object를 나타내는 String을 반환합니다.

Protected 생성자

protected 생성자WebRequest 생성자

.NET Compact Framework에서 지원

오버로드되었습니다. WebRequest 클래스의 새 인스턴스를 초기화합니다.

Protected 메서드

protected 메서드Finalize(Object에서 상속)

.NET Compact Framework에서 지원

재정의되었습니다. 가비지 수집기에서 Object를 회수하기 전에 Object가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다.

C# 및 C++에서 종결자는 소멸자 구문을 사용하여 표현됩니다.

protected 메서드MemberwiseClone(Object에서 상속)

.NET Compact Framework에서 지원

현재 Object의 단순 복사본을 만듭니다.

 

댓글
  • No Nickname
    No Comment
  • 권한이 없습니다.
    {{m_row.m_nick}}
    -
제목 작성자 날짜
공대여자
공대여자
mins01
mins
mins
mins
mins
mins
공대여자
mins
mins
mins
mins
mins
mins
mins
mins
mins