WebHeaderCollection.Remove Method (String)
Removes the specified header from the collection.
Namespace: System.Net
Assembly: System (in System.dll)
Parameters
- name
- Type: System.String
The name of the header to remove from the collection.
| Exception | Condition |
|---|---|
| ArgumentNullException | name is null Empty. |
| ArgumentException | name is a restricted header. -or- name contains invalid characters. |
Remove deletes the specified header from the collection. If the specified header does not exist, the method returns.
The following example uses the Remove method to remove a header from the WebHeaderCollection. After the header is removed, this example prints all existing headers to the screen to prove that it has been removed.
try { // Create a web request for "www.msn.com". HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("http://www.msn.com"); // Get the headers associated with the request. WebHeaderCollection myWebHeaderCollection = myHttpWebRequest.Headers; // Set the Cache-Control header. myWebHeaderCollection.Set("Cache-Control", "no-cache"); // Get the associated response for the above request. HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse(); // Print the headers of the request to console. Console.WriteLine("Print request headers after adding Cache-Control for first request:"); printHeaders(myHttpWebRequest.Headers); // Remove the Cache-Control header for the new request. myWebHeaderCollection.Remove("Cache-Control"); // Get the response for the new request. myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse(); // Print the headers of the new request without the Cache-Control header. Console.WriteLine("Print request headers after removing Cache-Control for the new request:"); printHeaders(myHttpWebRequest.Headers); myHttpWebResponse.Close(); } // Catch exception if trying to remove a restricted header. catch(ArgumentException e) { Console.WriteLine("Error : Trying to remove a restricted header"); Console.WriteLine("ArgumentException is thrown. Message is :" + e.Message); } catch(WebException e) { Console.WriteLine("WebException is thrown. Message is :" + e.Message); if(e.Status == WebExceptionStatus.ProtocolError) { Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode); Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription); Console.WriteLine("Server : {0}", ((HttpWebResponse)e.Response).Server); } } catch(Exception e) { Console.WriteLine("Exception is thrown. Message is :" + e.Message); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.