HttpWebRequest.Headers Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

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

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

Özel durumlar

InvalidOperationException

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

Örnekler

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

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

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.

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

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

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

İstek başlatıldıktan sonra Headers özelliğinin GetRequestStream, BeginGetRequestStream, GetResponseveya BeginGetResponse yöntemi çağrılarak 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.