xtd::diagnostics::trace_event_cache Class Reference

Inheritance diagram for xtd::diagnostics::trace_event_cache:

Definition

Provides trace event data specific to a thread and a process.

class core_export_ trace_event_cache : public xtd::object

Inheritance

xtd::object → xtd::diagnostics::trace_event_cache

Header

#include <xtd/diagnostics/trace_event_cache>

Namespace

xtd::diagnostics

Library

xtd.core

Public Constructors
	trace_event_cache ()=default
	Initializes a new instance of the trace_event_cache class.

Public Properties
auto	call_stack () const noexcept -> xtd::string
	Gets the call stack for the current thread.
auto	date_time () const noexcept -> const xtd::date_time &
	Gets the date and time at which the event trace occurred.
auto	logical_operation_stack () const noexcept -> xtd::array< xtd::string >
	Gets the correlation data, contained in a stack.
auto	process_id () const noexcept -> xtd::int32
	Gets the unique identifier of the current process.
auto	thread_id () const noexcept -> xtd::string
	Gets a unique identifier for the current managed thread.
auto	timestamp () const noexcept -> std::chrono::nanoseconds
	Gets the current number of ticks in the timer mechanism.
auto	timestamp_milliseconds () const noexcept -> xtd::int64
	Gets the current number of ticks in the timer mechanism, in milliseconds.
auto	timestamp_nanoseconds () const noexcept -> xtd::int64
	Gets the current number of ticks in the timer mechanism, in nanoseconds.
auto	timestamp_ticks () const noexcept -> xtd::int64
	Gets the current number of ticks in the timer mechanism, in nanoseconds.

Additional Inherited Members
	object ()=default
	Create a new instance of the ultimate base class object.
virtual auto	equals (const object &obj) const noexcept -> bool
	Determines whether the specified object is equal to the current object.
virtual auto	get_hash_code () const noexcept -> xtd::usize
	Serves as a hash function for a particular type.
virtual auto	get_type () const noexcept -> type_object
	Gets the type of the current instance.
template<typename object_t>
auto	memberwise_clone () const -> xtd::unique_ptr_object< object_t >
	Creates a shallow copy of the current object.
virtual auto	to_string () const -> xtd::string
	Returns a xtd::string that represents the current object.
template<typename object_a_t, typename object_b_t>
static auto	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are considered equal.
template<typename object_a_t, typename object_b_t>
static auto	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are the same instance.

Constructor & Destructor Documentation

trace_event_cache()

xtd::diagnostics::trace_event_cache::trace_event_cache ( )

default

Initializes a new instance of the trace_event_cache class.

Member Function Documentation

call_stack()

auto xtd::diagnostics::trace_event_cache::call_stack ( ) const -> xtd::string

nodiscardnoexcept

Gets the call stack for the current thread.

Returns

string A string containing stack trace information. This value can be an empty string ("").

Remarks

The Callstack property gets the call stack from the StackTrace property of the Environment class. The property value lists method calls in reverse chronological order. That is, the most recent method call is described first. One line of stack trace information is listed for each method call on the stack. For more information, see StackTrace.

date_time()

auto xtd::diagnostics::trace_event_cache::date_time ( ) const -> const xtd::date_time &

nodiscardnoexcept

Gets the date and time at which the event trace occurred.

Returns

DateTime A DateTime structure whose value is a date and time expressed in Coordinated Universal Time (UTC).

Remarks

The first time the property is accessed in an instance of the trace_event_cache class, the current time is returned. Subsequent queries of this property in that instance return that same DateTime value, allowing it to be used as a timestamp.

logical_operation_stack()

auto xtd::diagnostics::trace_event_cache::logical_operation_stack ( ) const -> xtd::array< xtd::string >

nodiscardnoexcept

Gets the correlation data, contained in a stack.

Returns

A Stack containing correlation data.

Remarks

The correlation data is stored as an object in the call context with the name "System.Diagnostics.Trace.CorrelationManagerSlot". The CorrelationManager class provides methods used to store a logical operation identity in a thread-bound context and automatically tag each trace event generated by the thread with the stored identity. The CorrelationManager is accessed through the Trace.CorrelationManager property. Each call to the StartLogicalOperation method pushes a new logical operation identity onto the stack. Each call to the StopLogicalOperation method pops a logical operation identity from the stack

process_id()

auto xtd::diagnostics::trace_event_cache::process_id ( ) const -> xtd::int32

nodiscardnoexcept

Gets the unique identifier of the current process.

Returns

int32 The system-generated unique identifier of the current process.

Remarks

Until the process terminates, the process identifier uniquely identifies the process throughout the system.

thread_id()

auto xtd::diagnostics::trace_event_cache::thread_id ( ) const -> xtd::string

nodiscardnoexcept

Gets a unique identifier for the current managed thread.

Returns

string A string that represents a unique integer identifier for this managed thread.

Remarks

The thread identifier is the value of the Thread.ManagedThreadId property formatted as a string.

timestamp()

auto xtd::diagnostics::trace_event_cache::timestamp ( ) const -> std::chrono::nanoseconds

nodiscardnoexcept

Gets the current number of ticks in the timer mechanism.

Returns

std::chrono::nanoseconds The nanoseconds counter value of the underlying timer mechanism.

Remarks

The get accessor calls the Stopwatch.GetTimestamp method to get the timestamp. If the Stopwatch class uses a high-resolution performance counter, GetTimestamp returns the current value of that counter. If the Stopwatch class uses the system timer, GetTimestamp returns the Ticks property of DateTime.Now.

timestamp_milliseconds()

auto xtd::diagnostics::trace_event_cache::timestamp_milliseconds ( ) const -> xtd::int64

nodiscardnoexcept

Gets the current number of ticks in the timer mechanism, in milliseconds.

Returns

int64 The millisecond counter value of the underlying timer mechanism.

Remarks

The get accessor calls the Stopwatch.GetTimestamp method to get the timestamp. If the Stopwatch class uses a high-resolution performance counter, GetTimestamp returns the current value of that counter. If the Stopwatch class uses the system timer, GetTimestamp returns the Ticks property of DateTime.Now.

timestamp_nanoseconds()

auto xtd::diagnostics::trace_event_cache::timestamp_nanoseconds ( ) const -> xtd::int64

nodiscardnoexcept

Gets the current number of ticks in the timer mechanism, in nanoseconds.

Returns

int64 The nanosecond counter value of the underlying timer mechanism.

Remarks

The get accessor calls the Stopwatch.GetTimestamp method to get the timestamp. If the Stopwatch class uses a high-resolution performance counter, GetTimestamp returns the current value of that counter. If the Stopwatch class uses the system timer, GetTimestamp returns the Ticks property of DateTime.Now.

timestamp_ticks()

auto xtd::diagnostics::trace_event_cache::timestamp_ticks ( ) const -> xtd::int64

nodiscardnoexcept

Gets the current number of ticks in the timer mechanism, in nanoseconds.

Returns

int64 The tick counter value of the underlying timer mechanism.

Remarks

The get accessor calls the Stopwatch.GetTimestamp method to get the timestamp. If the Stopwatch class uses a high-resolution performance counter, GetTimestamp returns the current value of that counter. If the Stopwatch class uses the system timer, GetTimestamp returns the Ticks property of DateTime.Now.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/diagnostics/trace_event_cache.hpp