Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ITraceWriterExtensions.TraceBeginEndAsync<TResult> Method (ITraceWriter, , String, TraceLevel, String, String, Action<TraceRecord>, Func<Task<TResult>>, Action<TraceRecord, TResult>, Action<TraceRecord>)

Traces both a begin and an end trace around a specified operation.

Namespace:  System.Web.Http.Tracing
Assembly:  System.Web.Http (in System.Web.Http.dll)
public static Task<TResult> TraceBeginEndAsync<TResult>(
	this ITraceWriter traceWriter,
	HttpRequestMessage request,
	string category,
	TraceLevel level,
	string operatorName,
	string operationName,
	Action<TraceRecord> beginTrace,
	Func<Task<TResult>> execute,
	Action<TraceRecord, TResult> endTrace,
	Action<TraceRecord> errorTrace
)

Type Parameters

TResult

The type of result produced by the Task.

Parameters

traceWriter
Type: System.Web.Http.Tracing.ITraceWriter

The ITraceWriter.

request
Type: HttpRequestMessage

The HttpRequestMessage with which to associate the trace. It may be null.

category
Type: System.String

The logical category of the trace.

level
Type: System.Web.Http.Tracing.TraceLevel

The TraceLevel of the trace.

operatorName
Type: System.String

The name of the object performing the operation. It may be null.

operationName
Type: System.String

The name of the operation being performed. It may be null.

beginTrace
Type: System.Action<TraceRecord>

The Action to invoke prior to performing the operation, allowing the given TraceRecord to be filled in. It may be null.

execute
Type: System.Func<Task<TResult>>

An <see cref="T:System.Func`1" /> that returns the Task that will perform the operation.

endTrace
Type: System.Action<TraceRecord, TResult>

The Action to invoke after successfully performing the operation, allowing the given TraceRecord to be filled in. The result of the completed task will also be passed to this action. This action may be null.

errorTrace
Type: System.Action<TraceRecord>

The Action to invoke if an error was encountered performing the operation, allowing the given TraceRecord to be filled in. It may be null.

Return Value

Type: System.Threading.Tasks.Task<TResult>
The Task returned by the operation.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type ITraceWriter. When you use instance method syntax to call this method, omit the first parameter. For more information, see http://msdn.microsoft.com/en-us/library/bb384936(v=vs.108).aspx or http://msdn.microsoft.com/en-us/library/bb383977(v=vs.108).aspx.

The end trace will occur when the asynchronous operation completes, either success or failure.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.