OperationCanceledException Constructor (String, Exception, CancellationToken)

Initializes a new instance of the OperationCanceledException class with a specified error message, a reference to the inner exception that is the cause of this exception, and a cancellation token.

Namespace:  System
Assemblies:   System.Threading.Tasks (in System.Threading.Tasks.dll)
  mscorlib (in mscorlib.dll)

public OperationCanceledException(
	string message,
	Exception innerException,
	CancellationToken token
)

Parameters

message
Type: System.String

The error message that explains the reason for the exception.

innerException
Type: System.Exception

The exception that is the cause of the current exception. If the innerException parameter is not null, the current exception is raised in a catch block that handles the inner exception.

token
Type: System.Threading.CancellationToken

A cancellation token associated with the operation that was canceled.

The content of message is intended to be understood by humans. The caller of this constructor is required to ensure that this string has been localized for the current system culture.

An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

The following table shows the initial property values for an instance of OperationCanceledException.

The following table shows the initial property values for an instance of OperationCanceledException.

Property Type

Condition

InnerException

innerException.

Message

message.

CancellationToken

token.

.NET Framework

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft