이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

WebRequest 클래스

 

게시 날짜: 2016년 11월

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

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

System.Object
  System.MarshalByRefObject
    System.Net.WebRequest
      System.IO.Packaging.PackWebRequest
      System.Net.FileWebRequest
      System.Net.FtpWebRequest
      System.Net.HttpWebRequest

[SerializableAttribute]
public abstract class WebRequest : MarshalByRefObject, ISerializable

이름설명
System_CAPS_protmethodWebRequest()

WebRequest 클래스의 새 인스턴스를 초기화합니다.

System_CAPS_protmethodWebRequest(SerializationInfo, StreamingContext)

WebRequestSerializationInfo 클래스의 지정된 인스턴스로부터 StreamingContext 클래스의 새 인스턴스를 초기화합니다.

이름설명
System_CAPS_pubpropertyAuthenticationLevel

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

System_CAPS_pubpropertyCachePolicy

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

System_CAPS_pubpropertyConnectionGroupName

파생 클래스에서 재정의되면 요청에 대한 연결 그룹 이름을 가져오거나 설정합니다.

System_CAPS_pubpropertyContentLength

하위 항목 클래스에서 재정의될 때, 전송 중인 요청 데이터의 콘텐츠 길이를 가져오거나 설정합니다.

System_CAPS_pubpropertyContentType

하위 항목 클래스에서 재정의될 때, 전송 중인 요청 데이터의 콘텐츠 형식을 가져오거나 설정합니다.

System_CAPS_pubpropertyCreatorInstance

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

System_CAPS_pubpropertyCredentials

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

System_CAPS_pubpropertySystem_CAPS_staticDefaultCachePolicy

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

System_CAPS_pubpropertySystem_CAPS_staticDefaultWebProxy

글로벌 HTTP 프록시를 가져오거나 설정합니다.

System_CAPS_pubpropertyHeaders

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

System_CAPS_pubpropertyImpersonationLevel

현재 요청에 대한 가장 수준을 가져오거나 설정합니다.

System_CAPS_pubpropertyMethod

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

System_CAPS_pubpropertyPreAuthenticate

하위 항목 클래스에서 재정의될 때, 요청을 사전 인증할지를 나타냅니다.

System_CAPS_pubpropertyProxy

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

System_CAPS_pubpropertyRequestUri

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

System_CAPS_pubpropertyTimeout

요청이 시간 초과되기 전의 시간(밀리초)을 가져오거나 설정합니다.

System_CAPS_pubpropertyUseDefaultCredentials

서브클래스에서 재정의된 경우 DefaultCredentials를 요청과 함께 보낼지 여부를 제어하는 Boolean 값을 가져오거나 설정합니다.

이름설명
System_CAPS_pubmethodAbort()

요청을 중단합니다.

System_CAPS_pubmethodBeginGetRequestStream(AsyncCallback, Object)

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

System_CAPS_pubmethodBeginGetResponse(AsyncCallback, Object)

하위 항목 클래스에서 재정의될 때, 인터넷 리소스에 대한 비동기 요청을 시작합니다.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

System_CAPS_pubmethodSystem_CAPS_staticCreate(Uri)

지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

System_CAPS_pubmethodSystem_CAPS_staticCreateDefault(Uri)

지정된 URI 체계에 대한 새 WebRequest 인스턴스를 초기화합니다.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(String)

지정된 URI 문자열에 대한 새 HttpWebRequest 인스턴스를 초기화합니다.

System_CAPS_pubmethodSystem_CAPS_staticCreateHttp(Uri)

지정된 URI에 대한 새 HttpWebRequest 인스턴스를 초기화합니다.

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodEndGetRequestStream(IAsyncResult)

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

System_CAPS_pubmethodEndGetResponse(IAsyncResult)

파생 클래스에서 재정의될 때, WebResponse를 반환합니다.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodFinalize()

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

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetLifetimeService()

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

System_CAPS_protmethodGetObjectData(SerializationInfo, StreamingContext)

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

System_CAPS_pubmethodGetRequestStream()

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

System_CAPS_pubmethodGetRequestStreamAsync()

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

System_CAPS_pubmethodGetResponse()

하위 항목 클래스에 재정의될 때, 인터넷 요청에 대한 응답을 반환합니다.

System_CAPS_pubmethodGetResponseAsync()

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

System_CAPS_pubmethodSystem_CAPS_staticGetSystemWebProxy()

현재 가장한 사용자의 Internet Explorer 설정에 구성된 프록시를 반환합니다.

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodInitializeLifetimeService()

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

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_protmethodMemberwiseClone(Boolean)

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

System_CAPS_pubmethodSystem_CAPS_staticRegisterPortableWebRequestCreator(IWebRequestCreate)

사용되지 않습니다. IWebRequestCreate 개체를 등록합니다.

System_CAPS_pubmethodSystem_CAPS_staticRegisterPrefix(String, IWebRequestCreate)

지정된 URI에 대한 WebRequest 하위 항목을 등록합니다.

System_CAPS_pubmethodToString()

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

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

이 API는 제품 인프라를 지원하며 코드에서 직접 사용할 수 없습니다. 서브클래스에서 재정의될 때, WebRequest를 serialize하는 데 필요한 데이터로 SerializationInfo 인스턴스를 채웁니다.

WebRequestabstract 기본 인터넷에서 데이터 액세스를 위한.NET Framework의 요청/응답 모델에 대 한 클래스입니다. 요청/응답 모델을 사용 하는 응용 프로그램의 인스턴스와 응용 프로그램이 동작 하는 프로토콜을 알 수 없는 방식으로 인터넷에서 데이터를 요청할 수는 WebRequest 프로토콜별 하위 클래스는 요청의 세부 정보를 수행 하는 동안 클래스입니다.

요청은 응용 프로그램에서 서버에 웹 페이지와 같은 특정 URI로 전송 됩니다. 목록에서 만들려는 적절 한 하위 클래스를 결정 하는 URI WebRequest 응용 프로그램에 등록 된 하위 항목입니다. WebRequest 하위 항목은 일반적으로 HTTP 또는 FTP와 같은 특정 프로토콜을 처리 하도록 등록 되어 있지만 서버에 대 한 경로 또는 특정 서버에 요청을 처리 하도록 등록할 수 있습니다.

WebRequest throw 클래스는 WebException 인터넷 리소스에 액세스 하는 동안 오류가 발생 한 경우. Status 속성은 중 하나는 WebExceptionStatus 오류의 출처를 나타내는 값입니다.StatusWebExceptionStatus.ProtocolError, Response 속성을 포함는 WebResponse 인터넷 리소스에서 수신 합니다.

때문에 WebRequest 클래스는는 abstract 클래스의 실제 동작이 WebRequest 인스턴스 실행 시 반환 된 하위 항목 클래스에 의해 결정 됩니다 Create 메서드. 예외에 대 한 자세한 내용은 하위 항목 클래스에 대 한 설명서를와 같은 참조 HttpWebRequestFileWebRequest합니다.

System_CAPS_note참고

사용 된 Create 새로운 초기화 하려면 메서드 WebRequest 인스턴스. 사용 하지 않는 WebRequest 생성자입니다.

System_CAPS_note참고

일반 사용자의 자격 증명으로도 다른 여러 가지 WebRequest 개체를 만드는 응용 프로그램을 실행 하는 경우 응용 프로그램 권한이 명시적으로 부여 되어 사용자에 게 작업을 수행 하려면 로컬 컴퓨터 저장소에 설치 된 인증서에 액세스할 수 없습니다.

상속자 참고 사항:

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

다음 예제에서는 만드는 방법을 보여 줍니다.는 WebRequest 인스턴스 및 응답을 반환 합니다.

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

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

WebPermission

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

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
1.1 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능

이 형식의 모든 public static(Visual Basic의 공유 Visual Basic의 경우) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전이 보장되지 않습니다.

맨 위로 이동
표시: