HttpWebRequest.Headers, propriété

La collection Headers contient les en-têtes de protocoles associés à la requête. Le tableau suivant énumère les en-têtes HTTP qui ne sont pas stockés dans la collection Headers, mais qui sont définis par le système, ou encore par des propriétés ou méthodes.

La méthode Add lève ArgumentException si vous tentez de définir un de ces en-têtes protégés.

La modification de la propriété Headers après le lancement de la requête en appelant la méthode GetRequestStream, BeginGetRequestStream, GetResponse ou BeginGetResponse lève InvalidOperationException.

Vous ne devez pas considérer que les valeurs d'en-tête resteront inchangées, car les serveurs Web et les caches peuvent modifier ou ajouter des en-têtes à une requête Web.

L'exemple de code suivant utilise la propriété Headers pour imprimer les paires nom-valeur de l'en-tête HTTP dans la console.

			// Create a new 'HttpWebRequest' Object to the mentioned URL.
			HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
			// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
			HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
			Console.WriteLine("\nThe HttpHeaders are \n\n\tName\t\tValue\n{0}",myHttpWebRequest.Headers);
			// Print the HTML contents of the page to the console. 
			Stream streamResponse=myHttpWebResponse.GetResponseStream();
			StreamReader streamRead = new StreamReader( streamResponse );
			Char[] readBuff = new Char[256];
			int count = streamRead.Read( readBuff, 0, 256 );
			Console.WriteLine("\nThe HTML contents of page the are  : \n\n ");	
			while (count > 0) 
			{
				String outputData = new String(readBuff, 0, count);
				Console.Write(outputData);
				count = streamRead.Read(readBuff, 0, 256);
			}
			// Close the Stream object.
			streamResponse.Close();
			streamRead.Close();
			// Release the HttpWebResponse Resource.
			myHttpWebResponse.Close();

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence