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 peut être utilisé pour 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’intégralité de la requête ait été reçue avant de renvoyer un Stream objet. En revanche, la GetBufferlessInputStream méthode retourne immédiatement l’objet Stream . Vous pouvez utiliser la méthode pour commencer à traiter le corps de l’entité avant que le contenu complet du corps ait été reçu.

Le corps de l’entité (ou autant que vous demandez et a été reçu) 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 des paramètres de la Read méthode pour spécifier la quantité du corps de l’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 à la fois les méthodes et EndRead les BeginRead méthodes. 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 devez utiliser cette méthode uniquement pour les scénarios dans lesquels 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 où une page .aspx s’exécute, 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 peut être utilisé pour 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()