HttpRequest.GetBufferlessInputStream 메서드

정의

네임스페이스:

System.Web

어셈블리:

System.Web.dll

들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 Stream 개체를 가져옵니다.

오버로드

GetBufferlessInputStream()	들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 Stream 개체를 가져옵니다.
GetBufferlessInputStream(Boolean)	들어오는 HTTP 엔터티 본문을 읽고 Stream 속성에서 설정된 요청 길이 제한을 선택적으로 사용하지 않도록 설정하는 데 사용할 수 있는 MaxRequestLength 개체를 가져옵니다.

GetBufferlessInputStream()

들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 Stream 개체를 가져옵니다.

public:
 System::IO::Stream ^ GetBufferlessInputStream();

public System.IO.Stream GetBufferlessInputStream ();

member this.GetBufferlessInputStream : unit -> System.IO.Stream

Public Function GetBufferlessInputStream () As Stream

반환

Stream

들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 Stream 개체입니다.

예외

HttpException

요청의 엔터티 본문이 이미 로드되거나 구문 분석되었습니다. 엔터티 본문을 로드하고 구문 분석하도록 하는 속성의 예는 다음과 같습니다.

• Form

• InputStream

• Files

• GetBufferedInputStream()

이 예외가 발생하지 않도록 하려면 먼저 ReadEntityBodyMode 메서드를 호출합니다. 엔터티 본문을 읽는 동안 클라이언트 연결이 끊긴 경우 이 예외도 throw됩니다.

설명

이 메서드는 속성을 사용하는 대신 사용할 수 있습니다 InputStream . 속성은 InputStream 개체를 반환 Stream 하기 전에 전체 요청이 수신될 때까지 기다립니다. 반면, 메서드는 GetBufferlessInputStream 개체를 Stream 즉시 반환합니다. 메서드를 사용하여 본문의 전체 내용을 받기 전에 엔터티 본문 처리를 시작할 수 있습니다.

엔터티 본문(또는 요청하여 받은 만큼)은 메서드와 같은 Read 메서드를 호출하여 스트림을 읽기 위해 이 메서드에서 반환되는 개체를 사용하는 경우에만 반환됩니다. 메서드의 매개 변수를 Read 사용하여 읽을 엔터티 본문의 양을 지정합니다.

이 메서드에서 ASP.NET 반환된 개체는 Stream 동기 및 비동기 읽기 메서드를 모두 지원합니다. 개체는 Stream 메서드와 EndRead 메서드를 BeginRead 모두 구현합니다. 비동기 메서드를 사용하면 요청 엔터티를 청크 단위로 비동기적으로 읽을 수 있으며, ASP.NET 비동기 읽기 루프의 각 반복 사이에 현재 스레드를 해제합니다.

이 메서드는 요청이 큰 파일을 업로드하고 업로드가 완료되기 전에 파일 콘텐츠에 액세스하기 시작하려는 경우에 유용할 수 있습니다. 그러나 엔터티 본문의 모든 처리를 인수하려는 시나리오에는 이 메서드만 사용해야 합니다. 즉, .aspx 페이지가 실행될 때까지 엔터티 본문이 이미 읽혀졌기 때문에 .aspx 페이지에서 이 메서드를 사용할 수 없습니다.

추가 정보

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

들어오는 HTTP 엔터티 본문을 읽고 Stream 속성에서 설정된 요청 길이 제한을 선택적으로 사용하지 않도록 설정하는 데 사용할 수 있는 MaxRequestLength 개체를 가져옵니다.

public:
 System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);

public System.IO.Stream GetBufferlessInputStream (bool disableMaxRequestLength);

member this.GetBufferlessInputStream : bool -> System.IO.Stream

Public Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As Stream

매개 변수

disableMaxRequestLength

Boolean

요청 길이 한계를 비활성화하려면 true이고, 그렇지 않으면 false입니다.

반환

Stream

들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 Stream 개체입니다.

예외

HttpException

요청의 엔터티 본문이 이미 로드되거나 구문 분석되었습니다. 엔터티 본문을 로드하고 구문 분석하도록 하는 속성의 예는 다음과 같습니다.

• Form 속성

• Files 속성

• InputStream 속성

• GetBufferedInputStream() 메서드

이 예외가 발생하지 않도록 하려면 먼저 ReadEntityBodyMode 메서드를 호출합니다. 엔터티 본문을 읽는 동안 클라이언트 연결이 끊긴 경우 이 예외도 throw됩니다.

설명

이 메서드에 대한 자세한 내용은 오버로드를 GetBufferlessInputStream() 참조하세요.

추가 정보

• GetBufferedInputStream()