Neoview ADO.NET Provider Manual (R2.5)
NOTE: Tracing can help you solve problems you might encounter. However, enabling tracing
does increase system overhead, depending on the message types and settings you select.
To control tracing, set these properties in the appSettings section of your application's XML
configuration, using the add tag:
• “Enabling/Disabling Tracing and Selecting Message Types — NeoviewTraceLevel ” (page 21)
• “Sending Tracing Output to the Console — NeoviewTraceConsole” (page 21)
• “Specifying a File for Tracing Output — NeoviewTraceFile ” (page 22)
See the example configuration file on Example 3-2 (page 22).
Enabling/Disabling Tracing and Selecting Message Types — NeoviewTraceLevel
The NeoviewTraceLevel property sets tracing on and off and allows selection of message types
to be returned.
Property type: string
There are six message types you can select to display:
• Error – error messages and exceptions
• Warning – warning messages
• Public – publicly accessible functions being called
• Internal – internal functions being called
• Detail – detailed messages
• Network – full network communication
Display a single message type or a combination of types by setting NeoviewTraceLevel equal
to a string in double quotation marks (“), separating multiple types with the vertical bar character
(|):
• NeoviewTraceLevel value = "Error"
• NeoviewTraceLevel value = "Error|Warning|Network"
You can also use four convenience settings to return pre-set combinations of messages, or to turn
tracing on and off:
• Info – includes Error, Warning, Public, Internal
• Verbose – includes Error, Warning, Public, Internal, Detail
• All – enable tracing and return all message types
• Off – disable tracing
NOTE: Setting NeoviewTraceLevel to an invalid value also disables tracing.
Example 3-1 Example Tracing Output
Constructors are shown as .ctor, null values are shown as (null).
Time TraceLevel Connection ID Remote Process <Class Name>.<Method Name> ~
(<Parameter Type>) <Parameter Value>
6/7/2010 2:53:11 PM Public ~ 37818817 ~ WMS0101.$Z0ZG ~ NeoviewConnection.CreateCommand
6/7/2010 2:53:11 PM Public ~ 37818817 ~ WMS0101.$Z0ZG ~ NeoviewCommand..ctor ~
(System.String) (null)
6/7/2010 2:53:11 PM Public ~ 37818817 ~ WMS0101.$Z0ZG ~ NeoviewCommand.ExecuteReader
~ (System.Data.CommandBehavior) Default
Sending Tracing Output to the Console — NeoviewTraceConsole
Set the NeoviewTraceConsole property to send tracing output to the built in .NET standard
tracing routine, System.Diagnostics.Trace. There are many ways you can capture these
messages; for example, you can use Visual Studio to display messages in the output window.
Tracing for ADO.NET on the Neoview Platform 21