implab/ImplabNet Files · Implab/Diagnostics/Trace.cs

preview version of Unity xml configuration

cin - - Load All Authors

File last commit:

r255:b00441e04738 v3


                r272:9d1cca834b05

Download file

             Trace.cs
        
                    132 lines
            
             | 5.5 KiB
            
                | text/x-csharp
            
             |
                CSharpLexer
            
             / Implab / Diagnostics / Trace.cs
          
                    History
                
                 |
                  Source
                 | Raw
                 |Copy content
                 |Copy permalink

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
      using System;

      using System.Collections.Generic;

      using System.Diagnostics;

      using System.Linq;

      using System.Text;

        cin
    
Adde workaround to the behaviour of the logical operations stack in conjuction...

              r255
            
      using System.Threading;

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
      using System.Threading.Tasks;

      namespace Implab.Diagnostics {

          public static class Trace<T> {

        cin
    
Adde workaround to the behaviour of the logical operations stack in conjuction...

              r255
            
              public static TraceSource TraceSource { get; } = new TraceSource(typeof(T).Name);

      #if NETFX_TRACE_BUG

              readonly static AsyncLocal<object> m_currentOperation = new AsyncLocal<object>();

      #endif 

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              /// <summary>

              /// Starts the logical operation nested to the current operation nested to the current one.

              /// </summary>

              public static void StartLogicalOperation() {

        cin
    
removed absolete Diagnostics classes

              r252
            
                  Trace.CorrelationManager.StartLogicalOperation();

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

              /// <summary>

              /// Starts the logical operation with the specified name, this name is usefull in logs.

              /// </summary>

              /// <param name="name">Name.</param>

        cin
    
Adde workaround to the behaviour of the logical operations stack in conjuction...

              r255
            
      #if NETFX_TRACE_BUG

              public static void StartLogicalOperation(object name) {

                  m_currentOperation.Value = name;

        cin
    
Implab.Diagnostics drafts

              r253
            
                  Trace.CorrelationManager.StartLogicalOperation(name);

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

        cin
    
Adde workaround to the behaviour of the logical operations stack in conjuction...

              r255
            
      #else

              public static void StartLogicalOperation(object name) {

                  Trace.CorrelationManager.StartLogicalOperation(name);

              }

      #endif

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              /// <summary>

              /// Ends the logical operation and restores the previous one.

              /// </summary>

        cin
    
removed absolete Diagnostics classes

              r252
            
              public static void StopLogicalOperation() {

                  Trace.CorrelationManager.StopLogicalOperation();

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

              /// <summary>

              /// Writes an informational message.

              /// </summary>

              /// <param name="format">Format.</param>

              /// <param name="arguments">Arguments.</param>

              [Conditional("TRACE")]

              public static void Log(string format, params object[] arguments) {

        cin
    
Implab.Diagnostics drafts

              r253
            
                  TraceSource.TraceEvent(TraceEventType.Information, 0, format, arguments);

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

              /// <summary>

              /// Writes a warning message.

              /// </summary>

              /// <param name="format">Format.</param>

              /// <param name="arguments">Arguments.</param>

              [Conditional("TRACE")]

              public static void Warn(string format, params object[] arguments) {

        cin
    
Implab.Diagnostics drafts

              r253
            
                  TraceSource.TraceEvent(TraceEventType.Warning, 0, format, arguments);

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

              [Conditional("TRACE")]

              public static void Error(string format, params object[] arguments) {

        cin
    
Implab.Diagnostics drafts

              r253
            
                  TraceSource.TraceEvent(TraceEventType.Error, 0, format, arguments);

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

              [Conditional("TRACE")]

              public static void Error(Exception err) {

        cin
    
Implab.Diagnostics drafts

              r253
            
                  TraceSource.TraceData(TraceEventType.Error, 0, err);

              }

              /// <summary>

              /// This method save the current activity, and transfers to the specified activity,

              /// emits <see cref="TraceEventType.Start"/> and returns a scope of the new

              /// activity.

              /// </summary>

              /// <param name="activityName">The name of the new activity/</param>

              /// <param name="activityId">The identifier of the activity to which 

              /// the control will be transferred</param>

              /// <returns>A scope of the new activity, dispose it to transfer

              /// the control back to the original activity.</returns>

              public static ActivityScope TransferActivity(string activityName, Guid activityId) {

                  var prev = Trace.CorrelationManager.ActivityId;

                  TraceSource.TraceTransfer(0, "Transfer", activityId);

                  Trace.CorrelationManager.ActivityId = activityId;

                  TraceSource.TraceEvent(TraceEventType.Start, 0, activityName);

                  return new ActivityScope(TraceSource, prev, 0, activityName);

              }

              /// <summary>

              /// Emits <see cref="TraceEventType.Start"/> and returns a scope of the

              /// activity.

              /// </summary>

              /// <param name="activityName">The name of the activity to start</param>

              /// <returns>A scope of the new activity, dispose it to emit

              /// <see cref="TraceEventType.Stop"/> for the current activity.</returns>

              public static ActivityScope StartActivity(string activityName) {

                  if (Trace.CorrelationManager.ActivityId == Guid.Empty)

                      Trace.CorrelationManager.ActivityId = Guid.NewGuid();

                  var prev = Trace.CorrelationManager.ActivityId;

                  TraceSource.TraceEvent(TraceEventType.Start, 0, activityName);

                  return new ActivityScope(TraceSource, prev, 0, activityName);

              }

              /// <summary>

              /// Creates new <see cref="LogicalOperation(string)"/> and calls

              /// to <see cref="CorrelationManager.StartLogicalOperation(object)"/>

              /// passing the created operation as identity. Calls

              /// <see cref="TraceSource.TraceData(TraceEventType, int, object)"/>

              /// to notify listeners on operation start.

              /// </summary>

              /// <param name="name">The name of the logical operation.</param>

              /// <returns>Logical operation scope, disposing it will stop

              /// logical operation and notify trace listeners.</returns>

              public static LogicalOperationScope LogicalOperation(string name) {

                  var operation = new LogicalOperation(name);

                  TraceSource.TraceData(TraceEventType.Information, TraceEventCodes.StartLogicalOperation, operation);

        cin
    
Adde workaround to the behaviour of the logical operations stack in conjuction...

              r255
            
                  StartLogicalOperation(operation);

        cin
    
Implab.Diagnostics drafts

              r253
            
                  return new LogicalOperationScope(TraceSource, operation);

        cin
    
Added class Trace<T> to manage channels for individual classes, if SomeClass...

              r212
            
              }

          }

      }

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	using System;
		using System.Collections.Generic;
		using System.Diagnostics;
		using System.Linq;
		using System.Text;
cin Adde workaround to the behaviour of the logical operations stack in conjuction...	r255	using System.Threading;
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	using System.Threading.Tasks;

		namespace Implab.Diagnostics {
		public static class Trace<T> {

cin Adde workaround to the behaviour of the logical operations stack in conjuction...	r255	public static TraceSource TraceSource { get; } = new TraceSource(typeof(T).Name);

		#if NETFX_TRACE_BUG
		readonly static AsyncLocal<object> m_currentOperation = new AsyncLocal<object>();
		#endif

cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	/// <summary>
		/// Starts the logical operation nested to the current operation nested to the current one.
		/// </summary>
		public static void StartLogicalOperation() {
cin removed absolete Diagnostics classes	r252	Trace.CorrelationManager.StartLogicalOperation();
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212
		}

		/// <summary>
		/// Starts the logical operation with the specified name, this name is usefull in logs.
		/// </summary>
		/// <param name="name">Name.</param>
cin Adde workaround to the behaviour of the logical operations stack in conjuction...	r255	#if NETFX_TRACE_BUG
		public static void StartLogicalOperation(object name) {
		m_currentOperation.Value = name;
cin Implab.Diagnostics drafts	r253	Trace.CorrelationManager.StartLogicalOperation(name);
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}
cin Adde workaround to the behaviour of the logical operations stack in conjuction...	r255	#else
		public static void StartLogicalOperation(object name) {
		Trace.CorrelationManager.StartLogicalOperation(name);
		}
		#endif
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212
		/// <summary>
		/// Ends the logical operation and restores the previous one.
		/// </summary>
cin removed absolete Diagnostics classes	r252	public static void StopLogicalOperation() {
		Trace.CorrelationManager.StopLogicalOperation();
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}

		/// <summary>
		/// Writes an informational message.
		/// </summary>
		/// <param name="format">Format.</param>
		/// <param name="arguments">Arguments.</param>
		[Conditional("TRACE")]
		public static void Log(string format, params object[] arguments) {
cin Implab.Diagnostics drafts	r253	TraceSource.TraceEvent(TraceEventType.Information, 0, format, arguments);
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}

		/// <summary>
		/// Writes a warning message.
		/// </summary>
		/// <param name="format">Format.</param>
		/// <param name="arguments">Arguments.</param>
		[Conditional("TRACE")]
		public static void Warn(string format, params object[] arguments) {
cin Implab.Diagnostics drafts	r253	TraceSource.TraceEvent(TraceEventType.Warning, 0, format, arguments);
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}

		[Conditional("TRACE")]
		public static void Error(string format, params object[] arguments) {
cin Implab.Diagnostics drafts	r253	TraceSource.TraceEvent(TraceEventType.Error, 0, format, arguments);
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}

		[Conditional("TRACE")]
		public static void Error(Exception err) {
cin Implab.Diagnostics drafts	r253	TraceSource.TraceData(TraceEventType.Error, 0, err);
		}

		/// <summary>
		/// This method save the current activity, and transfers to the specified activity,
		/// emits <see cref="TraceEventType.Start"/> and returns a scope of the new
		/// activity.
		/// </summary>
		/// <param name="activityName">The name of the new activity/</param>
		/// <param name="activityId">The identifier of the activity to which
		/// the control will be transferred</param>
		/// <returns>A scope of the new activity, dispose it to transfer
		/// the control back to the original activity.</returns>
		public static ActivityScope TransferActivity(string activityName, Guid activityId) {
		var prev = Trace.CorrelationManager.ActivityId;

		TraceSource.TraceTransfer(0, "Transfer", activityId);
		Trace.CorrelationManager.ActivityId = activityId;
		TraceSource.TraceEvent(TraceEventType.Start, 0, activityName);

		return new ActivityScope(TraceSource, prev, 0, activityName);
		}

		/// <summary>
		/// Emits <see cref="TraceEventType.Start"/> and returns a scope of the
		/// activity.
		/// </summary>
		/// <param name="activityName">The name of the activity to start</param>
		/// <returns>A scope of the new activity, dispose it to emit
		/// <see cref="TraceEventType.Stop"/> for the current activity.</returns>
		public static ActivityScope StartActivity(string activityName) {
		if (Trace.CorrelationManager.ActivityId == Guid.Empty)
		Trace.CorrelationManager.ActivityId = Guid.NewGuid();

		var prev = Trace.CorrelationManager.ActivityId;

		TraceSource.TraceEvent(TraceEventType.Start, 0, activityName);
		return new ActivityScope(TraceSource, prev, 0, activityName);
		}

		/// <summary>
		/// Creates new <see cref="LogicalOperation(string)"/> and calls
		/// to <see cref="CorrelationManager.StartLogicalOperation(object)"/>
		/// passing the created operation as identity. Calls
		/// <see cref="TraceSource.TraceData(TraceEventType, int, object)"/>
		/// to notify listeners on operation start.
		/// </summary>
		/// <param name="name">The name of the logical operation.</param>
		/// <returns>Logical operation scope, disposing it will stop
		/// logical operation and notify trace listeners.</returns>
		public static LogicalOperationScope LogicalOperation(string name) {
		var operation = new LogicalOperation(name);
		TraceSource.TraceData(TraceEventType.Information, TraceEventCodes.StartLogicalOperation, operation);
cin Adde workaround to the behaviour of the logical operations stack in conjuction...	r255	StartLogicalOperation(operation);
cin Implab.Diagnostics drafts	r253	return new LogicalOperationScope(TraceSource, operation);
cin Added class Trace<T> to manage channels for individual classes, if SomeClass...	r212	}
		}
		}