HttpRequest.GetBufferlessInputStream Méthode

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.

Exceptions

Remarques

Cette méthode offre une alternative à l’utilisation de la InputStream propriété . La InputStream propriété attend que l’ensemble de la demande ait été reçu avant de retourner un Stream objet . En revanche, la GetBufferlessInputStream méthode retourne l’objet Stream immédiatement. Vous pouvez utiliser la méthode pour commencer à traiter le corps de l’entité avant que le contenu complet du corps n’ait été reçu.

Le corps de l’entité (ou la quantité que vous demandez et a été reçue) 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 . Vous utilisez les paramètres de la Read méthode pour spécifier la quantité du corps d’entité à lire.

L’objet Stream retourné par ASP.NET de cette méthode prend en charge les méthodes de lecture synchrones et asynchrones. L’objet Stream implémente les BeginRead méthodes et EndRead . Les méthodes asynchrones vous permettent de lire de manière asynchrone l’entité de requête en blocs, tandis que ASP.NET libère le thread actuel entre chaque itération d’une boucle de lecture asynchrone.

Cette méthode peut être utile si la demande charge un fichier volumineux et que vous souhaitez commencer à accéder au contenu du fichier avant la fin du chargement. Toutefois, vous ne devez utiliser cette méthode que pour les scénarios où vous souhaitez prendre en charge tout le traitement du corps de l’entité. 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.

Voir aussi

• GetBufferedInputStream()

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

Retours

Objet Stream qui permet de lire le corps de l'entité HTTP entrante.

Exceptions

Remarques

Pour plus d’informations sur cette méthode, consultez la GetBufferlessInputStream() surcharge.

Voir aussi

• GetBufferedInputStream()