1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
|
<Type Name="DiagnosticsConfigurationHandler" FullName="System.Diagnostics.DiagnosticsConfigurationHandler">
<TypeSignature Language="C#" Maintainer="auto" Value="public class DiagnosticsConfigurationHandler : System.Configuration.IConfigurationSectionHandler" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
<AssemblyVersion>1.0.3300.0</AssemblyVersion>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Configuration.IConfigurationSectionHandler</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<summary>A .config file section handler that handles initialization of diagnostic messages (and related settings).</summary>
<remarks>
<para>Paraphrasing the .NET SDK documentation: "This type is for internal use ONLY. Please Ignore it."</para>
<para>We're Mono, so we can do better than that. This class handles the <system.diagostics/> element in the application .config file, permitting the management of <see cref="T:System.Diagnostics.TraceListener" />s, <see cref="T:System.Diagnostics.Switch" />es, and related classes.</para>
<para>This class is listed in the "machine.config" file, in a (XPath) /configuration/configSections/section element. Machine.config is read by <see cref="T:System.Configuration.ConfigurationSettings" /> during .config file handling.</para>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DiagnosticsConfigurationHandler ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Constructs a new instance of the <see cref="T:System.Diagnostics.DiagnosticsConfigurationHandler" /> class.</summary>
<remarks>
<para>Paraphrasing the .NET SDK documentation: "This type is for internal use ONLY. Please Ignore it."</para>
<para>We're Mono, so we can do better than that. This creates a new instance of the <see cref="T:System.Diagnostics.DiagnosticsConfigurationHandler" /> class.</para>
</remarks>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="Create">
<MemberSignature Language="C#" Value="public virtual object Create (object parent, object configContext, System.Xml.XmlNode section);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="parent" Type="System.Object" />
<Parameter Name="configContext" Type="System.Object" />
<Parameter Name="section" Type="System.Xml.XmlNode" />
</Parameters>
<Docs>
<param name="parent">Parent settings. Must be <see langword="null" /> or an object implementing the <see cref="T:System.Collections.IDictionary" /> and <see cref="T:System.ICloneable" /> interfaces.</param>
<param name="configContext">Ignored.</param>
<param name="section">The XML section from the .config file to parse.</param>
<summary>Parses and returns the settings in the specified XML element.</summary>
<returns>An object implementing the <see cref="T:System.Collections.IDictionary" /> interface which contains the settings specified in the XML section <paramref name="section" />.</returns>
<remarks>
<para>Parses the XML element <paramref name="section" />, interpreting it as if it were a <system.diagnostics/> .config file section (which, generally, it should be, except in the unit tests). During the parse, the following things are done:</para>
<list type="bullet">
<item>
<term>
<see cref="T:System.Diagnostics.TraceListener" />s are added and removed</term>
</item>
<item>
<term>
<see cref="T:System.Diagnostics.Switch" /> settings are recorded (which are later looked up by the Switch objects when the current values are needed)</term>
</item>
<item>
<term>The <see cref="T:System.Diagnositcs.DefaultTraceListener" /> is initialized, setting the <see cref="P:System.Diagnostics.DefaultTraceListener.AssertUiEnabled" /> and <see cref="P:System.Diagnostics.DefaultTraceListener.LogFileName" /> properties, if specified.</term>
</item>
</list>
<para>The <system.diagnostics/> .config file section is (or should be) specified elsewhere. The Mono Handbook would be a good place for this information, anyway...</para>
</remarks>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete("This class is obsoleted")</AttributeName>
</Attribute>
</Attributes>
</Type>
|