Skip to main content

70-562 Listeners


Listeners

System.Diagnostics.Trace is collectted by TraceListeners. A TraceListener is an object that receives trace outpout and writes it out. Writes to a file, asp.net, databse, external monitoring system.
When a trace listener is create it is added to the Trace.Listeners collection which lets the listener recieve all the output including asp.net.

All listeners are derived from the TraceListener abstract class which has a variety of methods. The tracelisteners are the same but differ by the type of media they are writting to.

The same data can go to mulitple listeners.

Fail: writes including the call stack
Write: Outputs the text
WRiteLine: Outputes with a craiage returen
Flush: Flushes the output buffer to the traget media
Close: Closes the uput stream in order to stop recieving the debugging and traing data.
DefaultTraceListener: ouputs to the output window, included in all the tracelisteners, others should be use to write elsewere
TextWriterTraceListener: Writes to a text file or a , nextowrk stream or console
EventLogTraceListener writes to a local or remote windows event log
ConsoleTraceListener: outputs to a console
DelimitedListeTraceListener: outputs to a stream
XmlWriterTraceListeners: To atext writer to a stream

They output in a different format to different listenres, can have mulitple listenrs.
Only messages written as Write or Warn are forwarded.

Both the Trace and Debug Classes share the same object, so writting to one is available to the other.

Trace switches: Lets you set the granularity of the messages sent to the listeners. They Derive from the System.Diagnostics.Switch class and are conto9led from the web,.config file. It this possible to configure the switch without recompling.

Various type of switches:
BooleanSwitch, toggles on or off. The instence is defined in code and should match the one in the web config, if it doesnt match, it is desabled.
TraceSwitch: if this switch is desiabled, it wont write, more granularity than boolean switch. Off, Error, Warning, Info, verbose, for example, warning includes Error.
SourceSwitch:

Switches are configured in the web.config, child of the configuration element, within the system.diagnositcs element, withing the switches element, the name can be any name defined but has to match thte one in the chosen in code.

The value is from 1 to 4 where 4 is verbose.

The default for depolyemnt is to have all switches to false.

After having created the switch, create the trace listeners in code to output tracing.

Trace listeners are int eh App_Code directory. They require the System.Diagnositics, and System.IIO namespaces.

Typicaly, listeners used are logfile and event log, create a switch, one boolean one multiswitch (TraceSwitch).

After having created the listener, it needs to be added to the collection of listeners, in Trace.Listeners.Add(EventListener).

Typically to get the path to a file iwthin the application, string appPath = HttpContext.Current.Request.PhysicalapolicationPath;

Different types of listeners require different types of preparation as seen in the case of getting the path to a log file example above.

Before writting, one makes a check to the boolean switch is enable, within that 'if' is the code that writes the trace listeners.

Comments

Post a Comment

Popular posts from this blog

React JS Patterns

React JS is always evolving, and evolving quickly. These evolutions can be very significant ones, for example, the addition of hooks. React has a lot of code patterns, often these patterns are motivated by the DRY and/or the open-close principle. These patterns sometimes come in to replace a previous one, yet the previous ones still stays in use, as a consequence, the list of patterns keep growing. The goal of the next few posts will be to list the patterns commonly used in React JS developpement. Some patterns are more specific to JSX and I will start with these, and maybe add patterns specific to Redux.
4 comments
Read more

Rxjs Forkjoin vs Zip

These Rxjs combination operators are handy to make Rest calls in parallel and combine their results. Both take n observables and will return the results, with the difference that forkJoin will complete even if one of the nested observables errors of completes.
Post a Comment
Read more

Object.create vs. Object.Assign

The two functions return a new Object but with a difference. Object.assign will go through an enumerable and copy it's properties. Object.create will create a new empty object but link it's proto chain to the old object. One way to view this is with JSON.stringify(newCreatedObject) this would return an empty object, since all the properties are not part of the object's own properties, but inherited through prototype inheritance. In both case, the advantage is it allows to extended existing objects without modifying the original. This is particularly important when receiving arguments from a caller, in this case it's better to use these methods instead of modifying the caller's object since he might have planned to use it again later, expecting it to be in it's original state.
Post a Comment
Read more