TraceSource.Attributes Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the custom switch attributes defined in the application configuration file.

Namespace:   System.Diagnostics
Assembly:  System (in System.dll)

public StringDictionary Attributes { get; }

Property Value

Type: System.Collections.Specialized.StringDictionary

A StringDictionary containing the custom attributes for the trace switch.

The Attributes property identifies the custom attributes referenced in the application's configuration file. Unreferenced custom attributes are not enumerated. Classes that inherit from the TraceSource class can add custom attributes by overriding the Switch.GetSupportedAttributes method and returning a string array of custom attribute names.

The following is a sample of a trace source element specifying the custom attribute SecondTraceSourceAttribute:

<sources>
  <source name="TraceTest" switchName="TestSourceSwitch" 
    switchType="Testing.MySourceSwitch, TraceSample" 
    SecondTraceSourceAttribute="two">
  </source>
</sources>

The following code sample shows how to display the custom attributes for a TraceSource. This code example is part of a larger example provided for the TraceSource class.

// Get the custom attributes for the TraceSource.
Console.WriteLine("Number of custom trace source attributes = "
    + ts.Attributes.Count);
foreach (DictionaryEntry de in ts.Attributes)
    Console.WriteLine("Custom trace source attribute = "
        + de.Key + "  " + de.Value);

.NET Framework
Available since 2.0
Return to top
Show: