HttpWebResponse.Close Method

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Source:

HttpWebResponse.cs

Closes the response stream.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Exceptions

ObjectDisposedException

.NET Core only: This HttpWebResponse object has been disposed.

Examples

The following example demonstrates how to close a HttpWebResponse.

// Creates an HttpWebRequest for the specified URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( url ) );
// Sends the HttpWebRequest and waits for a response.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
Console::WriteLine( "\nResponse Received::Trying to Close the response stream.." );
// Releases the resources of the response.
myHttpWebResponse->Close();
Console::WriteLine( "\nResponse Stream successfully closed" );

// Creates an HttpWebRequest for the specified URL.
    HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.Create(url);
    // Sends the HttpWebRequest and waits for a response.
    HttpWebResponse myHttpWebResponse = (HttpWebResponse)myHttpWebRequest.GetResponse();
    Console.WriteLine("\nResponse Received.Trying to Close the response stream..");
    // Releases the resources of the response.
    myHttpWebResponse.Close();
    Console.WriteLine("\nResponse Stream successfully closed");

' Creates an HttpWebRequest for the specified URL. 
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create(url), HttpWebRequest)
' Sends the HttpWebRequest and waits for a response.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine("Response Received.Trying to Close the response stream..")
' Releases the resources of the response.
myHttpWebResponse.Close()
Console.WriteLine("Response Stream successfully closed")

Remarks

The Close method closes the response stream and releases the connection to the resource for reuse by other requests.

You should not access any properties of the HttpWebResponse object after the call to the Close method. On .NET Core, an ObjectDisposedException is thrown.

You must call either the Stream.Close or the HttpWebResponse.Close method to close the stream and release the connection for reuse. It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error. Failure to close the stream can cause your application to run out of connections.

Note

This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework.