WebRequest.Headers-Eigenschaft

Artikel
08/20/2007

Ruft beim Überschreiben in einer untergeordneten Klasse eine Auflistung von Name-Wert-Paaren für Header ab, die mit der Anforderung verknüpft sind, oder legt diese fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overridable Property Headers As WebHeaderCollection
'Usage
Dim instance As WebRequest
Dim value As WebHeaderCollection

value = instance.Headers

instance.Headers = value

public virtual WebHeaderCollection Headers { get; set; }

public:
virtual property WebHeaderCollection^ Headers {
    WebHeaderCollection^ get ();
    void set (WebHeaderCollection^ value);
}

/** @property */
public WebHeaderCollection get_Headers ()

/** @property */
public void set_Headers (WebHeaderCollection value)

public function get Headers () : WebHeaderCollection

public function set Headers (value : WebHeaderCollection)

Eigenschaftenwert

Eine WebHeaderCollection mit den dieser Anforderung zugeordneten Name-Wert-Paaren für Header.

Ausnahmen

Ausnahmetyp	Bedingung
NotImplementedException	Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer abgeleiteten Klasse nicht überschrieben wurde.

Hinweise

Die Headers-Eigenschaft enthält eine WebHeaderCollection-Instanz mit den an die Internetressource zu sendenden Headerinformationen.

Hinweis

Die WebRequest-Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest-Instanzen zur Laufzeit wird von der abgeleiteten Klasse bestimmt, die von der System.Net.WebRequest.Create-Methode zurückgegeben wird. Weitere Informationen über Standardwerte und Ausnahmen finden Sie in der Dokumentation zu den abgeleiteten Klassen, z. B. HttpWebRequest und FileWebRequest.

Beispiel

Im folgenden Beispiel werden die dieser Anforderung zugeordneten Name-Wert-Paare für Header angezeigt.

    ' Create a new request to the mentioned URL.    
    Dim myWebRequest As WebRequest = WebRequest.Create("https://www.contoso.com")
    
   ' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
   
    Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
   ' Release the resources of response object.
   
 myWebResponse.Close()
Console.WriteLine(ControlChars.Cr + "The HttpHeaders are " + ControlChars.Cr + "{0}", myWebRequest.Headers)

         // Create a new request to the mentioned URL.    
WebRequest myWebRequest=WebRequest.Create("https://www.contoso.com");        

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

// Release the resources of response object.
myWebResponse.Close();
Console.WriteLine("\nThe HttpHeaders are \n{0}",myWebRequest.Headers);

// Create a new request to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "https://www.contoso.com" );

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Release the resources of response object.
myWebResponse->Close();
Console::WriteLine( "\nThe HttpHeaders are \n {0}", myWebRequest->Headers );

// Create a new request to the mentioned URL.    
WebRequest myWebRequest = WebRequest.Create("https://www.contoso.com");
// Assign the response object of 'WebRequest' to a
// 'WebResponse' variable.
WebResponse myWebResponse = myWebRequest.GetResponse();
// Release the resources of response object.
myWebResponse.Close();
Console.WriteLine("\nThe HttpHeaders are \n{0}", myWebRequest.
    get_Headers());

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

WebRequest-Klasse
WebRequest-Member
System.Net-Namespace
WebHeaderCollection-Klasse
HttpWebRequest.Headers-Eigenschaft

Freigeben über