Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpWebRequest.GetRequestStream méthode (TransportContext)

.NET Framework (current version)
 

Date de publication : novembre 2016

Obtient un objet Stream à utiliser pour écrire les données de la requête et exporte le TransportContext associé au flux.

Espace de noms:   System.Net
Assembly:  System (dans System.dll)

public Stream GetRequestStream(
	out TransportContext context
)

Paramètres

context
Type: System.Net.TransportContext

TransportContext pour Stream.

Valeur de retour

Type: System.IO.Stream

Stream à utiliser pour écrire les données de la requête.

Exception Condition
Exception

La méthode GetRequestStream n’a pas pu obtenir le Stream.

InvalidOperationException

La méthode GetRequestStream est appelée plusieurs fois.

ou

TransferEncoding est défini sur une valeur et SendChunked a la valeur false.

NotSupportedException

Le validateur du cache de requête a indiqué que la réponse à cette requête peut être obtenue à partir du cache. Toutefois, les requêtes qui écrivent des données ne doivent pas utiliser le cache. Cette exception peut se produire si vous utilisez un validateur de cache personnalisé qui n’est pas implémenté correctement.

ProtocolViolationException

La propriété Method est GET ou HEAD.

ou

KeepAlive a la valeur true, AllowWriteStreamBuffering a la valeur false, ContentLength a la valeur -1, SendChunked a la valeur false, et Method a la valeur POST ou PUT.

WebException

Abort a déjà été appelé.

ou

Le délai d’attente de la requête a expiré.

ou

Une erreur s’est produite pendant le traitement de la requête.

Le GetRequestStream méthode retourne un flux à utiliser pour envoyer des données pour le HttpWebRequest et fournit en sortie le TransportContext associée au flux. Après le Stream objet a été renvoyé, vous pouvez envoyer des données avec le HttpWebRequest à l’aide de la Stream.Write (méthode).

Certaines applications qui utilisent l’authentification Windows intégrée avec protection étendue peut-être être en mesure d’interroger la couche de transport utilisée par HttpWebRequest afin de récupérer le jeton de liaison de canal (FAO) du canal de TLS sous-jacent. Le GetRequestStream méthode fournit l’accès à ces informations pour les méthodes HTTP qui ont un corps de demande (POST et PUT demandes). Cela est uniquement nécessaire si l’application implémente sa propre authentification et a besoin d’accéder à la FAO.

Si une application doit définir la valeur de la ContentLength propriété, puis il doit être effectuée avant de récupérer le flux.

Vous devez appeler la Stream.Close méthode pour fermer le flux et libérer la connexion en vue de leur réutilisation. Échec de fermer le flux indique à votre application à court de connexions.

System_CAPS_noteRemarque

Votre application ne peut pas combiner des méthodes synchrones et asynchrones pour une demande spécifique. Si vous appelez le GetRequestStream (méthode), vous devez utiliser le GetResponse méthode pour récupérer la réponse.

System_CAPS_noteRemarque

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d'informations, consultez Traçage réseau dans le .NET Framework.

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: