CorrelationManager Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

Zdroj:

CorrelationManager.cs

Koreluje trasování, které jsou součástí logické transakce.

public ref class CorrelationManager

public class CorrelationManager

type CorrelationManager = class

Public Class CorrelationManager

Dědičnost

Object

CorrelationManager

Příklady

Následující příklad kódu ukazuje použití CorrelationManager třídy identifikací logické operace přidružené ke trasované události. Spustí se dvě logické operace, jedna v hlavním vlákně a druhá v pracovním vlákně. V obou logických operacích se zaprotokoluje chybová událost.

using System;
using System.Collections.Generic;
using System.Text;
using System.Diagnostics;
using System.Threading;

namespace CorrlationManager
{
    class Program
    {
        //private static TraceSource ts;
        static void Main(string[] args)
        {
            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");
            ts.TraceEvent(TraceEventType.Error, 1, "Trace an error event.");
            Thread t = new Thread(new ThreadStart(ThreadProc));
            // Start the worker thread.
            t.Start();
            // Give the worker thread a chance to execute.
            Thread.Sleep(1000);
            Trace.CorrelationManager.StopLogicalOperation();
        }
        public static void ThreadProc()
        {
            TraceSource ts = new TraceSource("MyApp");
            int i = ts.Listeners.Add(new ConsoleTraceListener());
            ts.Listeners[i].TraceOutputOptions = TraceOptions.LogicalOperationStack;
            ts.Switch = new SourceSwitch("MyAPP", "Verbose");
            // Add another logical operation.
            Trace.CorrelationManager.StartLogicalOperation("WorkerThread");
            ts.TraceEvent(TraceEventType.Error, 1, "Trace an error event.");
            Trace.CorrelationManager.StopLogicalOperation();
        }
    }
}
// This sample generates the following output:
//MyApp Error: 1 : Trace an error event.
//    LogicalOperationStack=MainThread
//MyApp Error: 1 : Trace an error event.
//    LogicalOperationStack=WorkerThread, MainThread

Imports System.Collections.Generic
Imports System.Text
Imports System.Diagnostics
Imports System.Threading



Class Program
    
    'private static TraceSource ts;
    Shared Sub Main(ByVal args() As String) 
        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")
        ts.TraceEvent(TraceEventType.Error, 1, "Trace an error event.")
        Dim t As New Thread(New ThreadStart(AddressOf ThreadProc))
        ' Start the worker thread.
        t.Start()
        ' Give the worker thread a chance to execute.
        Thread.Sleep(1000)
        Trace.CorrelationManager.StopLogicalOperation()
    
    End Sub
    
    Public Shared Sub ThreadProc() 
        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")
        ' Add another logical operation.
        Trace.CorrelationManager.StartLogicalOperation("WorkerThread")
        ts.TraceEvent(TraceEventType.Error, 1, "Trace an error event.")
        Trace.CorrelationManager.StopLogicalOperation()
    
    End Sub
End Class
' This sample generates the following output:
'MyApp Error: 1 : Trace an error event.
'    LogicalOperationStack=MainThread
'MyApp Error: 1 : Trace an error event.
'    LogicalOperationStack=WorkerThread, MainThread

Poznámky

Trasování vygenerovaná z jedné logické operace lze označit jedinečnou identitou operace, aby bylo možné je odlišit od trasování od jiné logické operace. Může být například užitečné seskupit korelované trasování podle ASP.NET požadavku. Třída CorrelationManager poskytuje metody sloužící k uložení identity logické operace v kontextu vázaném na vlákno a automaticky označí každou událost trasování vygenerovanou vláknem s uloženou identitou.

Logické operace lze také vnořit. Vlastnost LogicalOperationStack zveřejňuje zásobník vnořených identit logických operací. Každé volání StartLogicalOperation metody nasdílí do zásobníku novou identitu logické operace. Každé volání StopLogicalOperation metody zobrazí identitu logické operace mimo zásobník.

Poznámka:

Identity logických operací jsou objekty, což umožňuje použití typu pro identitu logické operace.

Vlastnosti

Name	Description
ActivityId	Získá nebo nastaví identitu pro globální aktivitu.
LogicalOperationStack	Získá zásobník logických operací z kontextu volání.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
StartLogicalOperation()	Spustí logickou operaci ve vlákně.
StartLogicalOperation(Object)	Spustí logickou operaci se zadanou identitou ve vlákně.
StopLogicalOperation()	Zastaví aktuální logickou operaci.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)