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 , , GetRequestStream()BeginGetRequestStream(AsyncCallback, Object)veya GetResponse() yöntemi çağrılarak BeginGetResponse(AsyncCallback, Object)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

Caution

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.

Header	Ayar ölçütü
Kabul etmek	özelliğine Accept göre ayarlayın.
Connection	özelliğine ve Connection özelliğine KeepAlive 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.
Date	özelliğine Date göre ayarlayın.
Host	özelliğine Host göre ayarlayın.
If-Modified-Since	özelliğine IfModifiedSince göre ayarlayın.
Menzil	yöntemine göre AddRange ayarlayın.
Yönlendiren	ö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 , , GetRequestStreamBeginGetRequestStreamveya GetResponse yöntemi çağrılarak BeginGetResponseö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.