HttpWebRequest.Headers Eigenschaft

Definition

Gibt eine Auflistung der Name-Wert-Paare an, aus denen sich die HTTP-Header zusammensetzen.Specifies a collection of the name/value pairs that make up the HTTP headers.

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

Eigenschaftswert

Eine WebHeaderCollection mit den Name-Wert-Paaren, aus denen sich die Header für die HTTP-Anforderung zusammensetzen.A WebHeaderCollection that contains the name/value pairs that make up the headers for the HTTP request.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird die Headers-Eigenschaft verwendet, um die Name-Wert-Paare der http-Kopfzeile in der Konsole auszugeben.The following code example uses the Headers property to print the HTTP header name/value pairs to the 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 = gcnew StreamReader( streamResponse );
array<Char>^ readBuff = gcnew array<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 = gcnew String( readBuff,0,count );
   Console::Write( outputData );
   count = streamRead->Read( readBuff, 0, 256 );
}
streamResponse->Close();
streamRead->Close();
// Release the HttpWebResponse Resource.
myHttpWebResponse->Close();
// 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()

Hinweise

Die Headers-Auflistung enthält die Protokoll Header, die der Anforderung zugeordnet sind.The Headers collection contains the protocol headers associated with the request. In der folgenden Tabelle werden die HTTP-Header aufgelistet, die nicht in der Headers-Auflistung gespeichert sind, jedoch entweder vom System festgelegt oder durch Eigenschaften oder Methoden festgelegt werden.The following table lists the HTTP headers that are not stored in the Headers collection but are either set by the system or set by properties or methods.

HeaderHeader Festgelegt vonSet by
AnnehmenAccept Wird von der Accept-Eigenschaft festgelegt.Set by the Accept property.
VerbindungConnection Wird von der Connection-Eigenschaft und KeepAlive-Eigenschaft festgelegt.Set by the Connection property and KeepAlive property.
Inhalts LängeContent-Length Wird von der ContentLength-Eigenschaft festgelegt.Set by the ContentLength property.
InhaltstypContent-Type Wird von der ContentType-Eigenschaft festgelegt.Set by the ContentType property.
ExpectExpect Wird von der Expect-Eigenschaft festgelegt.Set by the Expect property.
DatumDate Wird von der Date-Eigenschaft festgelegt.Set by the Date property.
HostHost Wird von der Host-Eigenschaft festgelegt.Set by the Host property.
If-Modified-SinceIf-Modified-Since Wird von der IfModifiedSince-Eigenschaft festgelegt.Set by the IfModifiedSince property.
BereichRange Wird durch die AddRange-Methode festgelegt.Set by the AddRange method.
RefererReferer Wird von der Referer-Eigenschaft festgelegt.Set by the Referer property.
Übertragungs CodierungTransfer-Encoding Wird von der TransferEncoding-Eigenschaft festgelegt (die SendChunked-Eigenschaft muss "true" lauten).Set by the TransferEncoding property (the SendChunked property must be true).
User-AgentUser-Agent Wird von der UserAgent-Eigenschaft festgelegt.Set by the UserAgent property.

Durch die Add-Methode wird eine ArgumentException ausgelöst, wenn Sie versuchen, einen dieser geschützten Header festzulegen.The Add method throws an ArgumentException if you try to set one of these protected headers.

Wenn Sie die Headers-Eigenschaft ändern, nachdem die Anforderung durch Aufrufen von GetRequestStream, BeginGetRequestStream, GetResponseoder BeginGetResponse Methode gestartet wurde, wird ein InvalidOperationExceptionausgelöst.Changing the Headers property after the request has been started by calling GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method throws an InvalidOperationException.

Sie sollten nicht davon ausgehen, dass die Header Werte unverändert bleiben, da Webserver und Caches eine Webanforderung ändern oder Header hinzufügen können.You should not assume that the header values will remain unchanged, because Web servers and caches may change or add headers to a Web request.

Gilt für: