HttpWebRequest.GetRequestStream Méthode

Définition

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

Surcharges

GetRequestStream()

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

GetRequestStream(TransportContext)

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

GetRequestStream()

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

public:
 override System::IO::Stream ^ GetRequestStream();
public override System.IO.Stream GetRequestStream ();
override this.GetRequestStream : unit -> System.IO.Stream
Public Overrides Function GetRequestStream () As Stream

Retours

Stream

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

Exceptions

La propriété Method est GET ou HEAD.

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

Le validateur du cache de demande a indiqué que la réponse à cette demande peut être obtenue à partir du cache. Toutefois, les demandes 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 est implémenté de manière incorrecte.

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

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

  • ou - Une erreur s’est produite lors du traitement de la demande.

Dans une application .NET Compact Framework, un flux de requête avec une longueur de contenu nulle n’a pas été obtenu et s’est fermé correctement. Pour plus d’informations sur la gestion des requêtes avec une longueur de contenu nulle, consultez Programmation réseau dans le .NET Compact Framework.

Exemples

L’exemple de code suivant utilise la GetRequestStream méthode pour renvoyer une instance de flux.

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest->Method = "POST";
Console::WriteLine( "\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :" );

// Create a new String* Object* to POST data to the Url.
String^ inputData = Console::ReadLine();

String^ postData = String::Concat( "firstone= ", inputData );
ASCIIEncoding^ encoding = gcnew ASCIIEncoding;
array<Byte>^ byte1 = encoding->GetBytes( postData );

// Set the content type of the data being posted.
myHttpWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the content length of the String* being posted.
myHttpWebRequest->ContentLength = byte1->Length;

Stream^ newStream = myHttpWebRequest->GetRequestStream();

newStream->Write( byte1, 0, byte1->Length );
Console::WriteLine( "The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest->ContentLength );

// Close the Stream Object*.
newStream->Close();
// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST";
Console.WriteLine ("\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :");

// Create a new string object to POST data to the Url.
string inputData = Console.ReadLine ();


string postData = "firstone=" + inputData;
ASCIIEncoding encoding = new ASCIIEncoding ();
byte[] byte1 = encoding.GetBytes (postData);

// Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded";

// Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length;

Stream newStream = myHttpWebRequest.GetRequestStream ();

newStream.Write (byte1, 0, byte1.Length);
Console.WriteLine ("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength);

// Close the Stream object.
newStream.Close ();
' Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST"

Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :")
' Create a new string object to POST data to the Url.
Dim inputData As String = Console.ReadLine()
Dim postData As String = "firstone" + ChrW(61) + inputData
Dim encoding As New ASCIIEncoding()
Dim byte1 As Byte() = encoding.GetBytes(postData)
' Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded"
' Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length
Dim newStream As Stream = myHttpWebRequest.GetRequestStream()
newStream.Write(byte1, 0, byte1.Length)
Console.WriteLine("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength)
newStream.Close()

Remarques

La GetRequestStream méthode retourne un flux à utiliser pour envoyer des données pour le HttpWebRequest. Une fois l’objet Stream retourné, vous pouvez envoyer des données à l’aide HttpWebRequest de la Stream.Write méthode.

Si une application doit définir la valeur de la ContentLength propriété, cette opération 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 à réutiliser. L’échec de la fermeture du flux entraîne l’absence de connexions de votre application.

Notes

Votre application ne peut pas combiner des méthodes synchrones et asynchrones pour une requête particulière. Si vous appelez la GetRequestStream méthode, vous devez utiliser la GetResponse méthode pour récupérer la réponse.

Notes

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 Le suivi réseau dans .NET Framework.

Voir aussi

S’applique à

GetRequestStream(TransportContext)

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

public:
 System::IO::Stream ^ GetRequestStream([Runtime::InteropServices::Out] System::Net::TransportContext ^ % context);
public System.IO.Stream GetRequestStream (out System.Net.TransportContext? context);
public System.IO.Stream GetRequestStream (out System.Net.TransportContext context);
override this.GetRequestStream : TransportContext -> System.IO.Stream
Public Function GetRequestStream (ByRef context As TransportContext) As Stream

Paramètres

Retours

Stream

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

Exceptions

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

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

Le validateur du cache de demande a indiqué que la réponse à cette demande peut être obtenue à partir du cache. Toutefois, les demandes 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 est implémenté de manière incorrecte.

La propriété Method est GET ou HEAD.

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

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

  • ou - Une erreur s’est produite lors du traitement de la demande.

Remarques

La GetRequestStream méthode retourne un flux à utiliser pour envoyer des données pour le HttpWebRequest flux et génère l’associé TransportContext au flux. Une fois l’objet Stream retourné, vous pouvez envoyer des données à l’aide HttpWebRequest de la Stream.Write méthode.

Certaines applications qui utilisent des Authentification Windows intégrées avec une protection étendue peuvent être en mesure d’interroger la couche de transport utilisée HttpWebRequest pour récupérer le jeton de liaison de canal (CBT) à partir du canal TLS sous-jacent. La GetRequestStream méthode fournit l’accès à ces informations pour les méthodes HTTP qui ont un corps de requête (POST et PUT des requêtes). Cela n’est nécessaire que si l’application implémente son propre authentification et a besoin d’accéder au CBT.

Si une application doit définir la valeur de la ContentLength propriété, cette opération 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 à réutiliser. L’échec de la fermeture du flux entraîne l’absence de connexions de votre application.

Notes

Votre application ne peut pas combiner des méthodes synchrones et asynchrones pour une requête particulière. Si vous appelez la GetRequestStream méthode, vous devez utiliser la GetResponse méthode pour récupérer la réponse.

Notes

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 Le suivi réseau dans .NET Framework.

Voir aussi

S’applique à