SqlCommand::Cancel Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Tries to cancel the execution of a SqlCommand.

Namespace:   System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)

virtual void Cancel() override

If there is nothing to cancel, nothing occurs. However, if there is a command in process, and the attempt to cancel fails, no exception is generated.

In some, rare, cases, if you call ExecuteReader then call Close (implicitily or explicitly) before calling Cancel, and then call Cancel, the cancel command will not be sent to SQL Server and the result set can continue to stream after you call Close. To avoid this, make sure that you call Cancel before closing the reader or connection.

The following example demonstrates the use of the Cancel method.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top