Programming with Reflection

image\rwnprg32.gif TraceBufferSize property

 

Syntax

object.TraceBufferSize
object.TraceBufferSize = Value

Data type

Long

 

Description

Returns (first syntax line) or specifies (second syntax line) whether Reflection should use a buffer when writing to a trace file, and how large the buffer should be (measured in kilobytes).

When this property is 0 (the default), no buffer is used during tracing. Reflection opens the trace file, appends the data, and then closes the trace file for each trace record. This ensures that trace data is written to the file even if Reflection shuts down unexpectedly during the procedure being traced.

To speed up tracing, you can create a trace buffer by setting this property to a value greater than zero. Trace data is written first to the trace buffer and is copied to the trace file on disk when the buffer is full. When TraceBufferSize is greater than 0, the file is not closed until the trace is stopped.

Note: The buffer size is calculated after compression. This means that if TraceBufferSize is set to 100 and TraceFileCompressType is set to use Huffman compression (the default), approximately 200 KB of data will be transmitted before the data is written to the trace file.

Values

The default is 0. The range of values is 0-100. This value sets the size of the buffer in kilobytes.

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property