HttpWebRequest.Headers Eigenschaft

Definition

Gibt eine Auflistung der Name-Wert-Paare an, aus denen sich die HTTP-Header zusammensetzen.

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

WebHeaderCollection

Eine WebHeaderCollection mit den Name-Wert-Paaren, aus denen sich die Header für die HTTP-Anforderung zusammensetzen.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird die Headers Eigenschaft verwendet, um die HTTP-Headernamen/Wertpaare in die Konsole zu drucken.

// 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 Protokollheader, die der Anforderung zugeordnet sind. In der folgenden Tabelle sind die HTTP-Header aufgeführt, die nicht in der Headers Auflistung gespeichert sind, aber entweder vom System festgelegt oder von Eigenschaften oder Methoden festgelegt werden.

Header Festlegen nach
Akzeptieren Legen Sie die Accept Eigenschaft fest.
Verbindung Legen Sie die Connection Eigenschaft und KeepAlive Eigenschaft fest.
Content-Length Legen Sie die ContentLength Eigenschaft fest.
Content-Type Legen Sie die ContentType Eigenschaft fest.
Expect Legen Sie die Expect Eigenschaft fest.
Datum Legen Sie die Date Eigenschaft fest.
Host Legen Sie die Host Eigenschaft fest.
If-Modified-Since Legen Sie die IfModifiedSince Eigenschaft fest.
Bereich Legen Sie die AddRange Methode fest.
Referer Legen Sie die Referer Eigenschaft fest.
Transfer-Encoding Legen Sie die TransferEncoding Eigenschaft fest (die SendChunked Eigenschaft muss wahr sein).
User-Agent Legen Sie die UserAgent Eigenschaft fest.

Die Add Methode löst ein, wenn Sie versuchen, ArgumentException einen dieser geschützten Header festzulegen.

Das Ändern der Headers Eigenschaft nach dem Starten der Anforderung durch Aufrufen GetRequestStream, BeginGetRequestStream, , GetResponseoder BeginGetResponse Methode löst eine InvalidOperationException.

Sie sollten nicht davon ausgehen, dass die Headerwerte unverändert bleiben, da Webserver und Caches Kopfzeilen zu einer Webanforderung ändern oder hinzufügen können.

Gilt für