HttpWebRequest.Headers Свойство

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.Requests.dll

Исходный код:

HttpWebRequest.cs

Указывает коллекцию пар name/value, составляющих заголовки HTTP.

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

Значение свойства

WebHeaderCollection

Значение WebHeaderCollection , содержащее пары "имя-значение", составляющие заголовки HTTP-запроса.

Исключения

InvalidOperationException

Запрос был запущен путем вызова GetRequestStream()метода , BeginGetRequestStream(AsyncCallback, Object)GetResponse()или BeginGetResponse(AsyncCallback, Object) метода.

Примеры

В следующем примере кода свойство используется Headers для печати пар заголовков и значений HTTP в консоли.

// 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()

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Коллекция Headers содержит заголовки протокола, связанные с запросом. В следующей таблице перечислены заголовки HTTP, которые не хранятся в Headers коллекции, но задаются системой или задаются свойствами или методами.

Заголовок	Откладывать
Принимать	Задано свойством Accept .
Связь	Задано свойством и KeepAlive свойствомConnection.
Длина содержимого	Задано свойством ContentLength .
Тип контента	Задано свойством ContentType .
Ожидать	Задано свойством Expect .
Дата	Задано свойством Date .
Хозяин	Задано свойством Host .
If-Modified-Since	Задано свойством IfModifiedSince .
Диапазон	Задает метод AddRange .
Рефератор	Задано свойством Referer .
Transfer-Encoding	Задано свойством TransferEncoding ( SendChunked свойство должно быть true).
User-Agent	Задано свойством UserAgent .

Метод Add вызывает исключение ArgumentException , если вы пытаетесь задать один из этих защищенных заголовков.

Headers Изменение свойства после запуска запроса путем вызова GetRequestStream, BeginGetRequestStreamGetResponseили BeginGetResponse метода вызывает InvalidOperationExceptionисключение.

Не следует предположить, что значения заголовков останутся неизменными, так как веб-серверы и кэши могут изменять или добавлять заголовки в веб-запрос.