HttpRequest.GetBufferlessInputStream 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체를 가져옵니다.
오버로드
| Name | Description |
|---|---|
| GetBufferlessInputStream() |
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체를 가져옵니다. |
| GetBufferlessInputStream(Boolean) |
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체를 가져오며, 필요에 따라 속성에 MaxRequestLength 설정된 요청 길이 제한을 사용하지 않도록 설정합니다. |
GetBufferlessInputStream()
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체를 가져옵니다.
public:
System::IO::Stream ^ GetBufferlessInputStream();public System.IO.Stream GetBufferlessInputStream();member this.GetBufferlessInputStream : unit -> System.IO.StreamPublic Function GetBufferlessInputStream () As Stream반환
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체입니다.
예외
요청의 엔터티 본문이 이미 로드 및 구문 분석되었습니다. 엔터티 본문을 로드하고 구문 분석하는 속성의 예는 다음과 같습니다.
이 예외를 방지하려면 먼저 메서드를 호출합니다 ReadEntityBodyMode . 엔터티 본문을 읽는 동안 클라이언트의 연결이 끊어지는 경우에도 이 예외가 throw됩니다.
설명
이 메서드는 속성을 사용하는 대신 사용할 수 있습니다 InputStream . 속성은 InputStream 개체를 반환 Stream 하기 전에 전체 요청이 수신될 때까지 기다립니다. 반면, 메서드는 GetBufferlessInputStream 개체를 Stream 즉시 반환합니다. 본문의 전체 내용을 받기 전에 메서드를 사용하여 엔터티 본문 처리를 시작할 수 있습니다.
엔터티 본문(또는 요청하여 받은 만큼)은 메서드와 같은 Read 메서드를 호출하여 이 메서드에서 반환된 개체를 사용하여 스트림을 읽을 때만 반환됩니다. 메서드의 매개 변수를 Read 사용하여 읽을 엔터티 본문의 양을 지정합니다.
이 메서드에서 ASP.NET 반환된 개체는 Stream 동기 및 비동기 읽기 메서드를 모두 지원합니다. 개체는 Stream 메서드와 EndRead 메서드를 BeginRead 모두 구현합니다. 비동기 메서드를 사용하면 요청 엔터티를 청크 단위로 비동기적으로 읽을 수 있으며, ASP.NET 비동기 읽기 루프의 각 반복 사이에 현재 스레드를 해제합니다.
이 메서드는 요청이 큰 파일을 업로드하고 업로드가 완료되기 전에 파일 내용에 액세스하기 시작하려는 경우에 유용할 수 있습니다. 그러나 엔터티 본문의 모든 처리를 인수하려는 시나리오에만 이 메서드를 사용해야 합니다. 즉, .aspx 페이지가 실행될 때까지 엔터티 본문을 이미 읽었기 때문에 .aspx 페이지에서 이 메서드를 사용할 수 없습니다.
추가 정보
적용 대상
GetBufferlessInputStream(Boolean)
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체를 가져오며, 필요에 따라 속성에 MaxRequestLength 설정된 요청 길이 제한을 사용하지 않도록 설정합니다.
public:
System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);public System.IO.Stream GetBufferlessInputStream(bool disableMaxRequestLength);member this.GetBufferlessInputStream : bool -> System.IO.StreamPublic Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As Stream매개 변수
- disableMaxRequestLength
- Boolean
true요청 길이 제한을 사용하지 않도록 설정하려면 다음을 실행합니다. 그렇지 않으면 . false
반환
Stream 들어오는 HTTP 엔터티 본문을 읽는 데 사용할 수 있는 개체입니다.
예외
요청의 엔터티 본문이 이미 로드 및 구문 분석되었습니다. 엔터티 본문을 로드하고 구문 분석하는 속성의 예는 다음과 같습니다.
Form 속성입니다.
Files 속성입니다.
InputStream 속성입니다.
GetBufferedInputStream() 메서드입니다.
이 예외를 방지하려면 먼저 메서드를 호출합니다 ReadEntityBodyMode . 엔터티 본문을 읽는 동안 클라이언트의 연결이 끊어지는 경우에도 이 예외가 throw됩니다.
설명
이 메서드에 대한 자세한 내용은 오버로드를 GetBufferlessInputStream() 참조하세요.
