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

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

Ö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 = 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

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

Üst bilgi	Ayar ölçütü
Kabul Et	ö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.
Bekli -yoruz	özelliğine Expect göre ayarlayın.
Tarih	ö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.
Aralık	yöntemi tarafından AddRange ayarlanır.
Referer	ö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 değişebileceğinden veya Web isteğine üst bilgiler ekleyebileceğinden, üst bilgi değerlerinin değişmeden kalacağını varsaymamalısınız.