HttpWebRequest.Headers Özellik

Tanım

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

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

Özel durumlar

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

Şunlara uygulanır