HttpWebRequest.Headers Eigenschap

Definitie

Naamruimte:
System.Net
Assembly's:
System.dll, System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee geeft u een verzameling van de naam/waardeparen waaruit de HTTP-headers bestaan.

public:
 virtual property System::Net::WebHeaderCollection ^ Headers { System::Net::WebHeaderCollection ^ get(); void set(System::Net::WebHeaderCollection ^ value); };
public override System.Net.WebHeaderCollection Headers { get; set; }
member this.Headers : System.Net.WebHeaderCollection with get, set
Public Overrides Property Headers As WebHeaderCollection

Waarde van eigenschap

WebHeaderCollection

Een WebHeaderCollection die de naam-/waardeparen bevat waaruit de headers voor de HTTP-aanvraag bestaan.

Uitzonderingen

InvalidOperationException

De aanvraag is gestart door de methode , BeginGetRequestStream(AsyncCallback, Object)of GetResponse()BeginGetResponse(AsyncCallback, Object) de GetRequestStream()methode aan te roepen.

Voorbeelden

In het volgende codevoorbeeld wordt de Headers eigenschap gebruikt om de HTTP-headernaam/waardeparen af te drukken naar de 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();

     ' Create a new 'HttpWebRequest' Object to the mentioned URL.
     Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
     ' Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
     Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
     Console.WriteLine(ControlChars.Cr + "The HttpHeaders are " + ControlChars.Cr + ControlChars.Cr + ControlChars.Tab + "Name" + ControlChars.Tab + ControlChars.Tab + "Value" + ControlChars.Cr + "{0}", myHttpWebRequest.Headers)

     ' Print the HTML contents of the page to the console. 
     Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
     Dim streamRead As New StreamReader(streamResponse)
     Dim readBuff(256) As [Char]
     Dim count As Integer = streamRead.Read(readBuff, 0, 256)
     Console.WriteLine(ControlChars.Cr + "The HTML contents of page the are  : " + ControlChars.Cr + ControlChars.Cr + " ")
     While count > 0
         Dim outputData As New [String](readBuff, 0, count)
         Console.Write(outputData)
         count = streamRead.Read(readBuff, 0, 256)
     End While
' Close the Stream object.
streamResponse.Close()
streamRead.Close()
' Release the HttpWebResponse Resource.
 myHttpWebResponse.Close()

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De Headers verzameling bevat de protocolheaders die aan de aanvraag zijn gekoppeld. De volgende tabel bevat de HTTP-headers die niet zijn opgeslagen in de Headers verzameling, maar die zijn ingesteld door het systeem of worden ingesteld door eigenschappen of methoden.

Koptekst Ingesteld door
Accepteren Ingesteld door de Accept eigenschap.
Connection Ingesteld door de Connection eigenschap en KeepAlive eigenschap.
Lengte van inhoud Ingesteld door de ContentLength eigenschap.
Inhoudstype Ingesteld door de ContentType eigenschap.
Verwachten Ingesteld door de Expect eigenschap.
Date Ingesteld door de Date eigenschap.
Host Ingesteld door de Host eigenschap.
If-Modified-Since Ingesteld door de IfModifiedSince eigenschap.
Bereik Ingesteld door de AddRange methode.
Verwijzende functie Ingesteld door de Referer eigenschap.
Transfer-Encoding Ingesteld door de TransferEncoding eigenschap (de SendChunked eigenschap moet waar zijn).
User-Agent Ingesteld door de UserAgent eigenschap.

De Add methode genereert een ArgumentException als u probeert een van deze beveiligde headers in te stellen.

Als u de Headers eigenschap wijzigt nadat de aanvraag is gestart door het aanroepenGetRequestStream, BeginGetRequestStreamof GetResponseBeginGetResponse de methode genereert een InvalidOperationException.

U moet er niet van uitgaan dat de headerwaarden ongewijzigd blijven, omdat webservers en caches headers kunnen wijzigen of toevoegen aan een webaanvraag.

Van toepassing op