HttpWebRequest.Headers Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Requests.dll

Kaynak:

HttpWebRequest.cs

HTTP üst bilgilerini oluşturan ad/değer çiftlerinin koleksiyonunu belirtir.

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

Özellik Değeri

WebHeaderCollection

WebHeaderCollection HTTP isteğinin üst bilgilerini oluşturan ad/değer çiftlerini içeren bir.

Özel durumlar

InvalidOperationException

İstek , , BeginGetRequestStream(AsyncCallback, Object)GetResponse()veya BeginGetResponse(AsyncCallback, Object) yöntemi çağrılarak GetRequestStream()başlatıldı.

Örnekler

Aşağıdaki kod örneği, HTTP üst bilgi adı/değer çiftlerini konsola yazdırmak için özelliğini kullanır Headers .

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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Koleksiyon, Headers istekle ilişkili protokol üst bilgilerini içerir. Aşağıdaki tabloda, koleksiyonda Headers depolanmayan ancak sistem tarafından ayarlanan veya özelliklere veya yöntemlere göre ayarlanan HTTP üst bilgileri listelenir.

Üstbilgi	Ayar ölçütü
Almak	özelliğine Accept göre ayarlayın.
Bağlantı	özelliğine ve KeepAlive özelliğine Connection göre ayarlayın.
İçerik Uzunluğu	özelliğine ContentLength göre ayarlayın.
İçerik Türü	özelliğine ContentType göre ayarlayın.
Ummak	özelliğine Expect göre ayarlayın.
Tarih	özelliğine Date göre ayarlayın.
Ev sahibi	özelliğine Host göre ayarlayın.
If-Modified-Since	özelliğine IfModifiedSince göre ayarlayın.
Aralık	yöntemine göre AddRange ayarlayın.
Başvuran	özelliğine Referer göre ayarlayın.
Transfer-Encoding	özelliği tarafından TransferEncoding ayarlanır ( SendChunked özelliği true olmalıdır).
User-Agent	özelliğine UserAgent göre ayarlayın.

Bu Add korumalı üst bilgilerden birini ayarlamaya çalışırsanız yöntemi bir ArgumentException oluşturur.

Headers İstek başlatıldıktan sonra , , BeginGetRequestStreamGetResponseveya BeginGetResponse yöntemi çağrılarak GetRequestStreamözelliğinin değiştirilmesi bir InvalidOperationExceptionoluşturur.

Web sunucuları ve önbellekleri bir Web isteğinde değişiklik olabileceği veya üst bilgiler ekleyebileceği için üst bilgi değerlerinin değişmeden kalacağını varsaymamalısınız.