HttpWebRequest.Headers Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Eine WebHeaderCollection mit den Name-Wert-Paaren, aus denen sich die Header für die HTTP-Anforderung zusammensetzen.
Ausnahmen
Die Anforderung wurde durch Aufrufen der Methode GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), GetResponse() oder BeginGetResponse(AsyncCallback, Object) gestartet.
Beispiele
Im folgenden Codebeispiel wird die Headers -Eigenschaft verwendet, um die HTTP-Headernamen-Wert-Paare in der 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, aber entweder vom System festgelegt oder durch Eigenschaften oder Methoden festgelegt werden.
Header | Festlegen durch |
---|---|
Akzeptieren | Legen Sie durch die Accept -Eigenschaft fest. |
Verbindung | Legen Sie durch die -Eigenschaft und KeepAlive -ConnectionEigenschaft fest. |
Content-Length | Legen Sie durch die ContentLength -Eigenschaft fest. |
Content-Type | Legen Sie durch die ContentType -Eigenschaft fest. |
Expect | Legen Sie durch die Expect -Eigenschaft fest. |
Datum | Legen Sie durch die Date -Eigenschaft fest. |
Host | Legen Sie durch die Host -Eigenschaft fest. |
If-Modified-Since | Legen Sie durch die IfModifiedSince -Eigenschaft fest. |
Bereich | Legen Sie von der AddRange -Methode fest. |
Referer | Legen Sie durch die Referer -Eigenschaft fest. |
Transfer-Encoding | Durch die TransferEncoding -Eigenschaft festgelegt (die SendChunked -Eigenschaft muss true sein). |
User-Agent | Legen Sie durch die UserAgent -Eigenschaft fest. |
Die Add -Methode löst einen aus ArgumentException , wenn Sie versuchen, einen dieser geschützten Header festzulegen.
Wenn Sie die Headers Eigenschaft ändern, nachdem die Anforderung gestartet wurde, indem Sie die Methode , BeginGetRequestStream, GetResponseoder BeginGetResponse aufrufenGetRequestStream, löst eine ausInvalidOperationException.
Sie sollten nicht davon ausgehen, dass die Headerwerte unverändert bleiben, da Webserver und Caches Header einer Webanforderung ändern oder hinzufügen können.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für