xtd::diagnostics::trace_switch Class Reference

Inheritance diagram for xtd::diagnostics::trace_switch:

Definition

Provides a multilevel switch to control tracing and debug output without recompiling your code.

class core_export_ trace_switch : public xtd::diagnostics::switch_base

Inheritance

xtd::object → xtd::diagnostics::switch_base → xtd::diagnostics::trace_switch

Header

#include <xtd/diagnostics/trace_switch>

Namespace

xtd::diagnostics

Library

xtd.core

Remarks

You can use a trace switch to filter out messages based on their importance. The trace_switch class provides the trace_error, trace_warning, trace_info, and trace_verbose properties to test the level of the switch. The level property gets or sets the switch's trace_level.

You can set the level of a trace_switch through the application configuration file and then use the configured trace_switch level in your application. Alternately, you can create a trace_switch in your code and set the level directly to instrument a specific section of code.

Public Constructors
	trace_switch (const xtd::string &display_name, const xtd::string &description)
	Initializes a new instance of the xtd::diagnostics::trace_switch class, using the specified display name and description.
	trace_switch (const xtd::string &display_name, const xtd::string &description, const xtd::string &default_switch_value)
	Initializes a new instance of the xtd::diagnostics::trace_switch class, using the specified display name, description, and default value for the switch.

Public Properties
xtd::diagnostics::trace_level	level () const noexcept
	Gets the trace level that determines the messages the switch allows.
void	level (xtd::diagnostics::trace_level level) noexcept
	Sets the trace level that determines the messages the switch allows.
bool	trace_error () const noexcept
	Gets a value indicating whether the switch allows error-handling messages.
bool	trace_info () const noexcept
	Gets a value indicating whether the switch allows informational messages.
bool	trace_verbose () const noexcept
	Gets a value indicating whether the switch allows all messages.
bool	trace_warning () const noexcept
	Gets a value indicating whether the switch allows warning messages.

Protected Methods
void	on_switch_setting_changed () override
	Invoked when the switch_setting property is changed.
void	on_value_changed () override
	Invoked when the value property is changed.

Additional Inherited Members
Public Member Functions inherited from xtd::diagnostics::switch_base
const std::map< xtd::string, xtd::string > &	attributes () const noexcept
	Gets the custom switch attributes.
std::map< xtd::string, xtd::string > &	attributes () noexcept
	Gets the custom switch attributes.
void	attributes (const std::map< xtd::string, xtd::string > &attributes) noexcept
	Sets the custom switch attributes.
const xtd::string &	description () const noexcept
	Gets a description of the switch.
const xtd::string &	display_name () const noexcept
	Gets a name used to identify the switch.
bool	equals (const switch_base &value) const noexcept override
virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.
Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.
virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.
virtual type_object	get_type () const noexcept
	Gets the type of the current instance.
template<typename object_t >
xtd::uptr< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.
virtual xtd::string	to_string () const noexcept
	Returns a xtd::string that represents the current object.
Public Member Functions inherited from xtd::iequatable< switch_base >
virtual bool	equals (const switch_base &) const noexcept=0
	Indicates wheth er the current object is equal to another object of the same type.
Static Public Member Functions inherited from xtd::diagnostics::switch_base
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.
Static Public Member Functions inherited from xtd::object
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.
template<typename object_a_t , typename object_b_t >
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.
Protected Member Functions inherited from xtd::diagnostics::switch_base
	switch_base (const xtd::string &display_name, const xtd::string &description)
	Initializes a new instance of the switch_base class.
	switch_base (const xtd::string &display_name, const xtd::string &description, const xtd::string &default_switch_value)
	Initializes a new instance of the switch_base class.
int32	switch_setting () const noexcept
	Gets the current setting for this switch.
void	switch_setting (int32 switch_setting)
	Sets the current setting for this switch.
const xtd::string &	value () const noexcept
	Gets the value of the switch.
void	value (const xtd::string &value)
	Sets the value of the switch.
virtual std::vector< xtd::string >	get_supported_attributes () const noexcept
	Gets the custom attributes supported by the switch.

---

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

• xtd.core/include/xtd/diagnostics/trace_switch.h