HttpRequest.GetBufferlessInputStream Metodo

Definizione

Ottiene un oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso.Gets a Stream object that can be used to read the incoming HTTP entity body.

Overload

GetBufferlessInputStream()

Ottiene un oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso.Gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream(Boolean)

Ottiene un oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso, disabilitando facoltativamente il limite di lunghezza della richiesta impostato nella proprietà MaxRequestLength .Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

GetBufferlessInputStream()

Ottiene un oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso.Gets a Stream object that can be used to read the incoming HTTP entity body.

public:
 System::IO::Stream ^ GetBufferlessInputStream();
public System.IO.Stream GetBufferlessInputStream ();
member this.GetBufferlessInputStream : unit -> System.IO.Stream
Public Function GetBufferlessInputStream () As Stream

Restituisce

Oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso.A Stream object that can be used to read the incoming HTTP entity body.

Eccezioni

Il corpo dell'entità della richiesta è già stato caricato e analizzato.The request's entity body has already been loaded and parsed. Tra le proprietà che generano il caricamento e l'analisi del corpo entità vi sono:Examples of properties that cause the entity body to be loaded and parsed include the following:

Per evitare questa eccezione, chiamare il metodo di ReadEntityBodyMode per primo.To avoid this exception, call the ReadEntityBodyMode method first. Questa eccezione viene generata se il client viene disconnesso durante la lettura del corpo di entità.This exception is also thrown if the client disconnects while the entity body is being read.

Commenti

Questo metodo rappresenta un'alternativa all'utilizzo della InputStream proprietà.This method provides an alternative to using the InputStream property. La InputStream proprietà attende fino a quando non viene ricevuta l'intera richiesta prima che venga Stream restituito un oggetto.The InputStream property waits until the whole request has been received before it returns a Stream object. Al contrario, il GetBufferlessInputStream metodo restituisce immediatamente Stream l'oggetto.In contrast, the GetBufferlessInputStream method returns the Stream object immediately. È possibile usare il metodo per iniziare a elaborare il corpo dell'entità prima che sia stato ricevuto il contenuto completo del corpo.You can use the method to begin processing the entity body before the complete contents of the body have been received.

Il corpo dell'entità (o la maggior parte di esso richiesta ed è stato ricevuto) viene restituito solo quando si usa l'oggetto restituito da questo metodo per leggere il flusso, chiamando metodi come il Read metodo.The entity body (or as much of it as you request and has been received) is returned only when you use the object that is returned by this method to read the stream, by calling methods such as the Read method. Usare i Read parametri del metodo per specificare la quantità del corpo dell'entità da leggere.You use parameters of the Read method to specify how much of the entity body to read.

L' Stream oggetto restituito da ASP.NET da questo metodo supporta sia i metodi di lettura sincroni che quelli asincroni.The Stream object returned by ASP.NET from this method supports both synchronous and asynchronous read methods. L' Stream oggetto implementa entrambi i BeginRead metodi EndRead e.The Stream object implements both the BeginRead and EndRead methods. I metodi asincroni consentono di leggere in modo asincrono l'entità request in blocchi, mentre ASP.NET rilascia il thread corrente tra ogni iterazione di un ciclo di lettura asincrono.The asynchronous methods let you asynchronously read the request entity in chunks, while ASP.NET releases the current thread in between each iteration of an asynchronous read loop.

Questo metodo può essere utile se la richiesta sta caricando un file di grandi dimensioni e si desidera iniziare ad accedere al contenuto del file prima del completamento del caricamento.This method can be useful if the request is uploading a large file and you want to begin accessing the file contents before the upload is finished. Tuttavia, è consigliabile usare questo metodo solo per gli scenari in cui si desidera assumere tutte le elaborazioni del corpo dell'entità.However, you should only use this method for scenarios where you want to take over all processing of the entity body. Ciò significa che non è possibile utilizzare questo metodo da una pagina aspx perché, dal momento in cui viene eseguita una pagina aspx, il corpo dell'entità è già stato letto.This means that you cannot use this method from an .aspx page, because by the time an .aspx page runs, the entity body has already been read.

Vedi anche

GetBufferlessInputStream(Boolean)

Ottiene un oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso, disabilitando facoltativamente il limite di lunghezza della richiesta impostato nella proprietà MaxRequestLength .Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

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

Parametri

disableMaxRequestLength
Boolean

true per disabilitare il limite di lunghezza della richiesta; in caso contrario, false.true to disable the request-length limit; otherwise, false.

Restituisce

Oggetto Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in ingresso.A Stream object that can be used to read the incoming HTTP entity body.

Eccezioni

Il corpo dell'entità della richiesta è già stato caricato e analizzato.The request's entity body has already been loaded and parsed. Tra le proprietà che generano il caricamento e l'analisi del corpo entità vi sono:Examples of properties that cause the entity body to be loaded and parsed include the following: - La proprietà Form.- The Form property.

- La proprietà Files.- The Files property.

- La proprietà InputStream.- The InputStream property.

- Il metodo GetBufferedInputStream().- The GetBufferedInputStream() method.

Per evitare questa eccezione, chiamare il metodo di ReadEntityBodyMode per primo.To avoid this exception, call the ReadEntityBodyMode method first. Questa eccezione viene generata se il client viene disconnesso durante la lettura del corpo di entità.This exception is also thrown if the client disconnects while the entity body is being read.

Commenti

Per ulteriori informazioni su questo metodo, vedere l' GetBufferlessInputStream() overload di.For more information about this method, see the GetBufferlessInputStream() overload.

Vedi anche

Si applica a