CorrelationManager.StartLogicalOperation Method (Object) (System.Diagnostics)

Switch View :
ScriptFree
.NET Framework Class Library
CorrelationManager.StartLogicalOperation Method (Object)

Starts a logical operation with the specified identity on a thread.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
Syntax

Visual Basic
Public Sub StartLogicalOperation ( _
	operationId As Object _
)
C#
public void StartLogicalOperation(
	Object operationId
)
Visual C++
public:
void StartLogicalOperation(
	Object^ operationId
)
F#
member StartLogicalOperation : 
        operationId:Object -> unit 

Parameters

operationId
Type: System.Object
An object identifying the operation.
Exceptions

Exception Condition
ArgumentNullException

The operationId parameter is null.

Remarks

The operationId parameter can be any object, such as a String that allows the operation to be identified for tracing purposes. The object represented by operationId is added to the LogicalOperationStack property.

Examples

The following code example demonstrates the use of the StartLogicalOperation(Object) method by initializing a logical operation to be associated with the main thread. For the complete code example, see the CorrelationManager class.

Visual Basic

Dim ts As New TraceSource("MyApp")
Dim i As Integer = ts.Listeners.Add(New ConsoleTraceListener())
ts.Listeners(i).TraceOutputOptions = TraceOptions.LogicalOperationStack
ts.Switch = New SourceSwitch("MyAPP", "Verbose")
' Start the logical operation on the Main thread.
Trace.CorrelationManager.StartLogicalOperation("MainThread")


C#

TraceSource ts = new TraceSource("MyApp");
int i = ts.Listeners.Add(new ConsoleTraceListener());
ts.Listeners[i].TraceOutputOptions = TraceOptions.LogicalOperationStack;
ts.Switch = new SourceSwitch("MyAPP", "Verbose");
// Start the logical operation on the Main thread.
Trace.CorrelationManager.StartLogicalOperation("MainThread");


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference