WebHeaderCollection.Remove Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebHeaderCollection.dll

Remove o cabeçalho especificado da coleção.

Sobrecargas

Remove(HttpRequestHeader)	Remove o cabeçalho especificado da coleção.
Remove(HttpResponseHeader)	Remove o cabeçalho especificado da coleção.
Remove(String)	Remove o cabeçalho especificado da coleção.

Remove(HttpRequestHeader)

Origem:

WebHeaderCollection.cs

Remove o cabeçalho especificado da coleção.

public:
 void Remove(System::Net::HttpRequestHeader header);

public void Remove (System.Net.HttpRequestHeader header);

override this.Remove : System.Net.HttpRequestHeader -> unit

Public Sub Remove (header As HttpRequestHeader)

Parâmetros

header

HttpRequestHeader

A instância HttpRequestHeader a ser removida da coleção.

Exceções

InvalidOperationException

Essa instância WebHeaderCollection não permite instâncias de HttpRequestHeader.

Comentários

Remove exclui o cabeçalho especificado da coleção. Se o cabeçalho especificado não existir, o método não fará nada.

Remove(HttpResponseHeader)

Origem:

WebHeaderCollection.cs

Remove o cabeçalho especificado da coleção.

public:
 void Remove(System::Net::HttpResponseHeader header);

public void Remove (System.Net.HttpResponseHeader header);

override this.Remove : System.Net.HttpResponseHeader -> unit

Public Sub Remove (header As HttpResponseHeader)

Parâmetros

header

HttpResponseHeader

A instância HttpResponseHeader a ser removida da coleção.

Exceções

InvalidOperationException

Essa instância WebHeaderCollection não permite instâncias de HttpResponseHeader.

Comentários

Remove exclui o cabeçalho especificado da coleção. Se o cabeçalho especificado não existir, o método não fará nada.

Remove(String)

Origem:

WebHeaderCollection.cs

Remove o cabeçalho especificado da coleção.

public:
 override void Remove(System::String ^ name);

public override void Remove (string name);

override this.Remove : string -> unit

Public Overrides Sub Remove (name As String)

Parâmetros

name

String

O nome do cabeçalho a ser removido da coleção.

Exceções

ArgumentNullException

name é nullEmpty.

ArgumentException

name é um cabeçalho restrito.

- ou -

name contém caracteres inválidos.

Exemplos

O exemplo a seguir usa o Remove método para remover um cabeçalho do WebHeaderCollection. Depois que o cabeçalho é removido, este exemplo imprime todos os cabeçalhos existentes na tela para provar que ele foi removido.

try
{
   // Create a web request for S"www.msn.com".
   HttpWebRequest^ myHttpWebRequest = dynamic_cast<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 = dynamic_cast<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 = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());

   // Print the headers of the new request with->Item[Out] 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 : {0}", e->Message );
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "WebException is thrown. Message is : {0}", e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusCode );
      Console::WriteLine( "Status Description : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      Console::WriteLine( "Server : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->Server );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception is thrown. Message is : {0}", e->Message );
}

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);
}

Public Shared Sub Main()
  Try
        'Create a web request for "www.msn.com".
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.msn.com"), HttpWebRequest)
        
        'Get the headers associated with the request.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebRequest.Headers
        
        'Set the Cache-Control header.
        myWebHeaderCollection.Set("Cache-Control", "no-cache")
        
        'Get the associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        '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")
        
        'Code example for "Remove" method of "WebHeaderCollection" ends here.
        'Get the response for the new request.
        myHttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        '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 e As ArgumentException
        Console.WriteLine("Error : Trying to remove a restricted header")
        Console.WriteLine(e.Message)
    Catch e As WebException
        Console.WriteLine(e.Message)
        If e.Status = WebExceptionStatus.ProtocolError Then
            Console.WriteLine("Status Code : {0}", CType(e.Response, HttpWebResponse).StatusCode)
            Console.WriteLine("Status Description : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
            Console.WriteLine("Server : {0}", CType(e.Response, HttpWebResponse).Server)
        End If
    Catch e As Exception
        Console.WriteLine(e.Message)
    End Try

End Sub

Comentários

Remove exclui o cabeçalho especificado da coleção. Se o cabeçalho especificado não existir, o método retornará.