DbCommandInterceptionContext<TResult> Class

Definition

Represents contextual information associated with calls into IDbCommandInterceptor implementations including the result of the operation.

public class DbCommandInterceptionContext<TResult> : System.Data.Entity.Infrastructure.Interception.DbCommandInterceptionContext
type DbCommandInterceptionContext<'Result> = class
    inherit DbCommandInterceptionContext
Public Class DbCommandInterceptionContext(Of TResult)
Inherits DbCommandInterceptionContext

Type Parameters

TResult

The type of the operation's results.

Inheritance
DbCommandInterceptionContext<TResult>

Remarks

Instances of this class are publicly immutable for contextual information. To add contextual information use one of the With... or As... methods to create a new interception context containing the new information.

Constructors

DbCommandInterceptionContext<TResult>()

Constructs a new DbCommandInterceptionContext<TResult> with no state.

DbCommandInterceptionContext<TResult>(DbInterceptionContext)

Creates a new DbCommandInterceptionContext<TResult> by copying immutable state from the given interception context. Also see Clone()

Properties

CommandBehavior

The CommandBehavior that will be used or has been used to execute the command with a DbDataReader. This property is only used for ExecuteReader(CommandBehavior) and its async counterparts.

(Inherited from DbCommandInterceptionContext)
DbContexts

Gets all the DbContext instances associated with this interception context.

(Inherited from DbInterceptionContext)
Exception

If this property is set before the operation has executed, then execution of the operation will be suppressed and the set exception will be thrown instead. Otherwise, if the operation fails, then this property will be set to the exception that was thrown. In either case, interceptors that run after the operation can change this property to change the exception that will be thrown, or set this property to null to cause no exception to be thrown at all.

IsAsync

True if the operation is being executed asynchronously, otherwise false.

(Inherited from DbInterceptionContext)
IsExecutionSuppressed

When true, this flag indicates that that execution of the operation has been suppressed by one of the interceptors. This can be done before the operation has executed by calling SuppressExecution(), by setting an Exception to be thrown, or by setting the operation result using Result.

ObjectContexts

Gets all the ObjectContext instances associated with this interception context.

(Inherited from DbInterceptionContext)
OriginalException

If execution of the operation fails, then this property will contain the exception that was thrown. If the operation was suppressed or did not fail, then this property will always be null.

OriginalResult

If execution of the operation completes without throwing, then this property will contain the result of the operation. If the operation was suppressed or did not fail, then this property will always contain the default value for the generic type.

Result

If this property is set before the operation has executed, then execution of the operation will be suppressed and the set result will be returned instead. Otherwise, if the operation succeeds, then this property will be set to the returned result. In either case, interceptors that run after the operation can change this property to change the result that will be returned.

TaskStatus

Set to the status of the Task<TResult> after an async operation has finished. Not used for synchronous operations.

UserState
Obsolete.

Gets or sets a value containing arbitrary user-specified state information associated with the operation.

Methods

AsAsync()

Creates a new DbCommandInterceptionContext<TResult> that contains all the contextual information in this interception context together with the IsAsync flag set to true.

Clone()

Call this method when creating a copy of an interception context in order to add new state to it. Using this method instead of calling the constructor directly ensures virtual dispatch so that the new type will have the same type (and any specialized state) as the context that is being cloned.

Equals(Object)

Determines whether the specified object is equal to the current object.

FindUserState(String)

Gets a value containing arbitrary user-specified state information associated with the operation.

GetHashCode()

Serves as the default hash function.

GetType()

Gets the Type of the current instance.

SetUserState(String, Object)

Sets a value containing arbitrary user-specified state information associated with the operation.

SuppressExecution()

Prevents the operation from being executed if called before the operation has executed.

ToString()

Returns a string that represents the current object.

WithCommandBehavior(CommandBehavior)

Creates a new DbCommandInterceptionContext<TResult> that contains all the contextual information in this interception context together with the given CommandBehavior.

WithDbContext(DbContext)

Creates a new DbCommandInterceptionContext<TResult> that contains all the contextual information in this interception context with the addition of the given DbContext.

WithObjectContext(ObjectContext)

Creates a new DbCommandInterceptionContext<TResult> that contains all the contextual information in this interception context with the addition of the given ObjectContext.

Applies to