HttpRequest.GetBufferlessInputStream Méthode

Définition

Obtient un objet Stream qui permet de lire le corps de l'entité HTTP entrante.Gets a Stream object that can be used to read the incoming HTTP entity body.

Surcharges

GetBufferlessInputStream()

Obtient un objet Stream qui permet de lire le corps de l'entité HTTP entrante.Gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream(Boolean)

Obtient un objet Stream qui peut être utilisé pour lire le corps d'entité HTTP entrant, si vous désactivez éventuellement la longueur maximale de la requête définie dans la propriété 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()

Obtient un objet Stream qui permet de lire le corps de l'entité HTTP entrante.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

Retours

Objet Stream qui permet de lire le corps de l'entité HTTP entrante.A Stream object that can be used to read the incoming HTTP entity body.

Exceptions

Le corps de l'entité de la requête a déjà été chargé et analysé.The request's entity body has already been loaded and parsed. Les exemples de propriétés qui provoquent le chargement et l'analyse du corps de l'entité sont les suivants :Examples of properties that cause the entity body to be loaded and parsed include the following:

Pour éviter cette exception, appelez la méthode ReadEntityBodyMode en premier.To avoid this exception, call the ReadEntityBodyMode method first. Cette exception est également levée si le client se déconnecte lors de la lecture d'un corps d'entité.This exception is also thrown if the client disconnects while the entity body is being read.

Remarques

Cette méthode fournit une alternative à l’utilisation InputStream de la propriété.This method provides an alternative to using the InputStream property. La InputStream propriété attend que l’intégralité de la requête soit reçue avant de retourner un Stream objet.The InputStream property waits until the whole request has been received before it returns a Stream object. En revanche, la GetBufferlessInputStream méthode retourne l' Stream objet immédiatement.In contrast, the GetBufferlessInputStream method returns the Stream object immediately. Vous pouvez utiliser la méthode pour commencer à traiter le corps d’entité avant la réception du contenu complet du corps.You can use the method to begin processing the entity body before the complete contents of the body have been received.

Le corps de l’entité (ou la plupart de ses requêtes et de sa réception) est retourné uniquement lorsque vous utilisez l’objet retourné par cette méthode pour lire le flux, en appelant des méthodes telles que la Read méthode.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. Vous utilisez les paramètres de Read la méthode pour spécifier la partie du corps d’entité à lire.You use parameters of the Read method to specify how much of the entity body to read.

L' Stream objet retourné par ASP.net à partir de cette méthode prend en charge les méthodes de lecture synchrones et asynchrones.The Stream object returned by ASP.NET from this method supports both synchronous and asynchronous read methods. L' Stream objet implémente à la BeginRead fois EndRead les méthodes et.The Stream object implements both the BeginRead and EndRead methods. Les méthodes asynchrones vous permettent de lire de façon asynchrone l’entité de requête dans des segments, tandis que ASP.NET libère le thread actuel entre chaque itération d’une boucle de lecture asynchrone.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.

Cette méthode peut être utile si la demande télécharge un fichier volumineux et que vous souhaitez commencer à accéder au contenu du fichier avant que le téléchargement soit terminé.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. Toutefois, vous devez utiliser cette méthode uniquement pour les scénarios où vous souhaitez prendre le contrôle de tout le traitement du corps d’entité.However, you should only use this method for scenarios where you want to take over all processing of the entity body. Cela signifie que vous ne pouvez pas utiliser cette méthode à partir d’une page. aspx, car au moment de l’exécution d’une page. aspx, le corps de l’entité a déjà été lu.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.

Voir aussi

GetBufferlessInputStream(Boolean)

Obtient un objet Stream qui peut être utilisé pour lire le corps d'entité HTTP entrant, si vous désactivez éventuellement la longueur maximale de la requête définie dans la propriété 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

Paramètres

disableMaxRequestLength
Boolean

true pour désactiver la longueur maximale de la requête ; sinon, false.true to disable the request-length limit; otherwise, false.

Retours

Objet Stream qui permet de lire le corps de l'entité HTTP entrante.A Stream object that can be used to read the incoming HTTP entity body.

Exceptions

Le corps de l'entité de la requête a déjà été chargé et analysé.The request's entity body has already been loaded and parsed. Les exemples de propriétés qui provoquent le chargement et l'analyse du corps de l'entité sont les suivants :Examples of properties that cause the entity body to be loaded and parsed include the following: - La propriété Form- The Form property.

- La propriété Files- The Files property.

- La propriété InputStream- The InputStream property.

- La méthode GetBufferedInputStream()- The GetBufferedInputStream() method.

Pour éviter cette exception, appelez la méthode ReadEntityBodyMode en premier.To avoid this exception, call the ReadEntityBodyMode method first. Cette exception est également levée si le client se déconnecte lors de la lecture d'un corps d'entité.This exception is also thrown if the client disconnects while the entity body is being read.

Remarques

Pour plus d’informations sur cette méthode, consultez GetBufferlessInputStream() la surcharge.For more information about this method, see the GetBufferlessInputStream() overload.

Voir aussi

S’applique à