DispatchOperation Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Used to modify or extend the execution behavior of a specific service operation in a service endpoint. This class cannot be inherited.
public ref class DispatchOperation sealed
public sealed class DispatchOperation
type DispatchOperation = class
Public NotInheritable Class DispatchOperation
- Inheritance
-
DispatchOperation
Remarks
The DispatchOperation class is the location for run-time modifications and insertion point for custom extensions that are scoped to only one service operation. (To modify service run-time behavior for all messages in a contract, use the DispatchRuntime class.)
Install DispatchOperation modifications using a custom operation behavior object or a behavior at a larger scope in order to modify operations across a contract.
Use the Operations property to locate the DispatchOperation object that represents a particular service operation.
The Action, ReplyAction, FaultContractInfos, IsOneWay, IsTerminating, and Name properties obtain the respective values for the operation.
The TransactionAutoComplete and TransactionRequired properties specify transaction behavior.
The ReleaseInstanceBeforeCall and ReleaseInstanceAfterCall properties control the lifetime of the user-defined service object relative to the InstanceContext.
The DeserializeRequest, SerializeReply, and the Formatter properties enable explicit control over the conversion from messages to objects and vice versa.
The Impersonation property specifies the operation impersonation level.
The CallContextInitializers property inserts custom call context extensions for the operation. For more information, see ICallContextInitializer.
The AutoDisposeParameters property controls whether parameter objects are disposed when the service operation is completed.
The Invoker property to insert a custom invoker object.
The ParameterInspectors property enables you to insert a custom parameter inspector that you can use to inspect or modify parameters and return values.
Constructors
DispatchOperation(DispatchRuntime, String, String) |
Initializes a new instance of the DispatchOperation class using the specified dispatch run-time, name, and action values. |
DispatchOperation(DispatchRuntime, String, String, String) |
Initializes a new instance of the DispatchOperation class using the specified dispatch run-time, name, action, and reply action values. |
Properties
Action |
Gets the value of the action for this operation. |
AutoDisposeParameters |
Gets or sets whether parameters are to be automatically disposed. |
CallContextInitializers |
A collection of ICallContextInitializer objects that defines the methods that enable the initialization and recycling of thread-local storage with the thread that invokes user code. |
DeserializeRequest |
Gets or sets a value that indicates whether the Formatter property value is used to deserialize the request message. |
FaultContractInfos |
Gets a collection of FaultContractInfo objects that represent the specified SOAP faults for this operation. |
Formatter |
Gets or sets the formatter that deserializes messages into objects and serializes objects into messages. |
Impersonation |
Gets or sets a value that indicates the degree to which the operation requires impersonation. |
Invoker |
Gets or sets the IOperationInvoker object that invokes the user-defined method. |
IsInsideTransactedReceiveScope |
Gets or sets whether the scope of the operation is inside a transacted receive activity. |
IsOneWay |
Gets a value that indicates if the operation is a one-way operation. |
IsTerminating |
Gets or sets a value that indicates if this operation is the last one in a session. |
Name |
Gets the name of the operation. |
ParameterInspectors |
Gets or sets a collection of IParameterInspector objects that can inspect and modify inbound and outbound objects for a particular proxy method. |
Parent |
Gets the associated DispatchRuntime object. |
ReleaseInstanceAfterCall |
Gets or sets a value that specifies whether to recycle the service object after a call. |
ReleaseInstanceBeforeCall |
Gets or sets a value that specifies whether to recycle the service object prior to dispatching the call. |
ReplyAction |
Gets the action of the reply message for the operation. |
SerializeReply |
Gets or sets a value that specifies whether the Formatter object serializes reply messages. |
TransactionAutoComplete |
Gets or sets a value that specifies whether the current transaction automatically completes when the operation returns successfully. |
TransactionRequired |
Gets or sets a value that specifies whether the operation must execute within a transaction. |
Methods
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |