mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 3.6.0

Browse Source 
Former-commit-id: da6be194a6b1221998fc28233f2503bd61dd9d14
This commit is contained in:
Jo Shields
2014-08-13 10:39:27 +01:00
commit a575963da9
50588 changed files with 8155799 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

188
mcs/class/System/Documentation/en/System.Diagnostics/BooleanSwitch.xml Normal file
View File

@@ -0,0 +1,188 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="BooleanSwitch" FullName="System.Diagnostics.BooleanSwitch">
<TypeSignature Language="C#" Value="public class BooleanSwitch : System.Diagnostics.Switch" Maintainer="auto" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit BooleanSwitch extends System.Diagnostics.Switch" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Diagnostics.Switch</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.Diagnostics.SwitchLevel(typeof(System.Boolean))</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>You can use a Boolean trace switch to enable or disable messages based on their importance. Use the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property to get the current value of the switch.</para>
<para>You can enable or disable a <see cref="T:System.Diagnostics.BooleanSwitch" /> through the application configuration file and then use the configured <see cref="T:System.Diagnostics.BooleanSwitch" /> value in your application. Alternately, you can create a <see cref="T:System.Diagnostics.BooleanSwitch" /> in your code and set the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property directly to instrument a specific section of code.</para>
<para>To configure a <see cref="T:System.Diagnostics.BooleanSwitch" />, edit the configuration file that corresponds to the name of your application. Within this file, you can add or remove a switch, set a switch's value, or clear all the switches previously set by the application. The configuration file should be formatted like the following example.</para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;switches&gt;
&lt;add name="mySwitch" value="1"/&gt;
&lt;/switches&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
<para>This example configuration section defines a <see cref="T:System.Diagnostics.BooleanSwitch" /> with the <see cref="P:System.Diagnostics.Switch.DisplayName" /> property set to mySwitch and the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> value set to true. Within your application, you can use the configured switch value by creating a <see cref="T:System.Diagnostics.BooleanSwitch" /> with the same name, as shown in the following code example.</para>
<para>code reference: Classic BooleanSwitch.BooleanSwitch Example#2</para>
<para>By default, the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property is set using the value specified in the configuration file. Configure the switch with a value of 0 to set the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property to false; configure the switch with a nonzero value to set the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property to true. If the <see cref="T:System.Diagnostics.BooleanSwitch" /> constructor cannot find initial switch settings in the configuration file, the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property of the new switch is set to false by default.</para>
<para>You must enable tracing or debugging to use a switch. The following syntax is compiler specific. If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.</para>
<list type="bullet">
<item>
<para>To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.</para>
</item>
<item>
<para>To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. In Visual Basic, add the /d:TRACE=True flag to the compiler command line.</para>
</item>
</list>
<block subset="none" type="note">
<para>These debug and trace compiler switches are not required when using the <see cref="T:System.Diagnostics.BooleanSwitch" /> class in isolation. They are only required in conjunction with <see cref="T:System.Diagnostics.Trace" /> or <see cref="T:System.Diagnostics.Debug" /> methods that are conditionally compiled.</para>
</block>
<para>For more information on instrumenting your application, see <see cref="T:System.Diagnostics.Debug" /> and <see cref="T:System.Diagnostics.Trace" />. For more information about configuring and using trace switches, see <format type="text/html"><a href="8ab913aa-f400-4406-9436-f45bc6e54fbe">Trace Switches</a></format>.</para>
<block subset="none" type="note">
<para>To improve performance, you can make <see cref="T:System.Diagnostics.BooleanSwitch" /> members static in your class.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a simple on/off switch that controls debugging and tracing output.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public BooleanSwitch (string displayName, string description);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string displayName, string description) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="displayName" Type="System.String" />
<Parameter Name="description" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you create a <see cref="T:System.Diagnostics.BooleanSwitch" />, the <paramref name="displayName" /> parameter is used to find initial switch settings. If the constructor cannot find initial settings, the <see cref="P:System.Diagnostics.BooleanSwitch.Enabled" /> property is set to false (disabled).</para>
<para>To set the level of your <see cref="T:System.Diagnostics.BooleanSwitch" />, edit the configuration file corresponding to the name of your application. Within this file, you can add a switch and set its value, remove a switch, or clear all switches previously set by the application. The configuration file should be formatted like the following example: </para>
<code> &lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;switches&gt;
&lt;add name="mySwitch" value="10" /&gt;
&lt;add name="myNewSwitch" value="20" /&gt;
&lt;remove name="mySwitch" /&gt;
&lt;clear/&gt;
&lt;/switches&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
<block subset="none" type="note">
<para>The switches you created should be static.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.BooleanSwitch" /> class with the specified display name and description.</para>
</summary>
<param name="displayName">
<attribution license="cc4" from="Microsoft" modified="false" />The name to display on a user interface. </param>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />The description of the switch. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public BooleanSwitch (string displayName, string description, string defaultSwitchValue);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string displayName, string description, string defaultSwitchValue) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="displayName" Type="System.String" />
<Parameter Name="description" Type="System.String" />
<Parameter Name="defaultSwitchValue" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="displayName" /> parameter is used to set the value of the <see cref="P:System.Diagnostics.Switch.DisplayName" /> property, and the <paramref name="description" /> parameter is use to set the value of the <see cref="P:System.Diagnostics.Switch.Description" /> property. The <paramref name="defaultSwitchValue" /> parameter is saved as a field and used to initialize the <see cref="P:System.Diagnostics.Switch.Value" /> property on first reference. For more information about constructor use, see the <see cref="M:System.Diagnostics.BooleanSwitch.#ctor(System.String,System.String)" /> constructor.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.BooleanSwitch" /> class with the specified display name, description, and default switch value. </para>
</summary>
<param name="displayName">
<attribution license="cc4" from="Microsoft" modified="false" />The name to display on the user interface. </param>
<param name="description">
<attribution license="cc4" from="Microsoft" modified="false" />The description of the switch. </param>
<param name="defaultSwitchValue">
<attribution license="cc4" from="Microsoft" modified="false" />The default value of the switch.</param>
</Docs>
</Member>
<Member MemberName="Enabled">
<MemberSignature Language="C#" Value="public bool Enabled { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool Enabled" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>To be added: an object of type 'bool'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, this field is set to false (disabled). To enable the switch, assign this field the value of true. To disable the switch, assign the value to false. The value of this property is determined by the value of the base class property <see cref="P:System.Diagnostics.Switch.SwitchSetting" />.</para>
<block subset="none" type="note">
<para>This method uses the <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" /> flag to prevent being called from untrusted code; only the immediate caller is required to have <see cref="P:System.Security.Permissions.SecurityPermissionAttribute.UnmanagedCode" /> permission. If your code can be called from partially trusted code, do not pass the user input to <see cref="T:System.Runtime.InteropServices.Marshal" /> class methods without validation. For important limitations on using the LinkDemand member, see <format type="text/html"><a href="1ab877f2-70f4-4e0d-8116-943999dfe8f5">Demand vs. LinkDemand</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value indicating whether the switch is enabled or disabled.</para>
</summary>
</Docs>
</Member>
<Member MemberName="OnValueChanged">
<MemberSignature Language="C#" Value="protected override void OnValueChanged ();" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void OnValueChanged() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Diagnostics.BooleanSwitch.OnValueChanged" /> method determines whether the new value is a valid string representation of a Boolean value ("false" or "true"). If so, the method sets the <see cref="P:System.Diagnostics.Switch.SwitchSetting" /> property to 0 or 1. Otherwise, the base method is called, which converts the string value to an integer value, which is then used to set the <see cref="P:System.Diagnostics.Switch.SwitchSetting" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether the new value of the <see cref="P:System.Diagnostics.Switch.Value" /> property can be parsed as a Boolean value.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

105
mcs/class/System/Documentation/en/System.Diagnostics/ConsoleTraceListener.xml Normal file
View File

@@ -0,0 +1,105 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="ConsoleTraceListener" FullName="System.Diagnostics.ConsoleTraceListener">
<TypeSignature Language="C#" Value="public class ConsoleTraceListener : System.Diagnostics.TextWriterTraceListener" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit ConsoleTraceListener extends System.Diagnostics.TextWriterTraceListener" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Diagnostics.TextWriterTraceListener</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> class to write trace and debugging messages to the console. You can initialize a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to write trace messages to the <see cref="P:System.Console.Out" /> stream or to the <see cref="P:System.Console.Error" /> stream.</para>
<para>When trace and debugging output is enabled, the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> messages are written to the specified <see cref="T:System.Console" /> stream, which is similar to the way messages are written with the <see cref="Overload:System.Console.Write" /> or <see cref="Overload:System.Console.WriteLine" /> methods. In a console application, the <see cref="T:System.Console" /> output and error streams write messages to the existing console window, or you can redirect the streams to write to a <see cref="T:System.IO.TextWriter" /> instance.</para>
<block subset="none" type="note">
<para>If the console does not exist, as in a Windows-based application, messages written to the console are not displayed.</para>
</block>
<para>Add a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to the appropriate <see cref="P:System.Diagnostics.Trace.Listeners" /> collection if you want messages written through <see cref="T:System.Diagnostics.Trace" />, <see cref="T:System.Diagnostics.TraceSource" />, or <see cref="T:System.Diagnostics.Debug" /> to be written to the console. In addition, you can write messages directly to the console using the <see cref="Overload:System.Diagnostics.Trace.Write" /> or <see cref="Overload:System.Diagnostics.Trace.WriteLine" /> methods.</para>
<block subset="none" type="note">
<para>The <see cref="T:System.Diagnostics.Debug" /> and <see cref="T:System.Diagnostics.Trace" /> classes share the same <see cref="T:System.Diagnostics.TraceListenerCollection" /> collection, accessed through their respective Listeners properties. If you add a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to the collection using one of these classes, the other class automatically uses the same listener.</para>
</block>
<para>Most compilers enable trace and debug output through conditional compilation flags. If you do not enable tracing or debugging, the messages written through the <see cref="T:System.Diagnostics.Debug" /> and <see cref="T:System.Diagnostics.Trace" /> classes are effectively ignored. The syntax to enable trace and debug output is compiler specific; if you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.</para>
<list type="bullet">
<item>
<para>To enable debugging in C#, add the <system>/d:DEBUG</system> flag to the compiler command line when you compile your code, or you can add <system>#define DEBUG</system> to the top of your file. In Visual Basic, add the <system>/d:DEBUG=True</system> flag to the compiler command line.</para>
</item>
<item>
<para>To enable tracing in C#, add the <system>/d:TRACE</system> flag to the compiler command line when you compile your code, or add <system>#define TRACE</system> to the top of your file. In Visual Basic, add the <system>/d:TRACE=True</system> flag to the compiler command line.</para>
</item>
</list>
<para>You can add a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection in your code, or you can add a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection through the application configuration file. Add the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object in your code to write messages for a specific code section or execution path. Add the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object in your application configuration file to direct all trace and debug messages to the console while the application executes.</para>
<para>To write trace and debug messages to the console for a specific section of code, initialize a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object and add it to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection. Instrument the section of code that contains messages using the <see cref="T:System.Diagnostics.Trace" /> or <see cref="T:System.Diagnostics.Debug" /> classes. At the end of the code section, remove the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object from the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection, and call the <see cref="M:System.Diagnostics.TextWriterTraceListener.Close" /> method on the <see cref="T:System.Diagnostics.ConsoleTraceListener" />.</para>
<para>To direct all trace and debug messages to the console while the application executes, add a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to the application configuration file. Edit the configuration file that corresponds to the name of your application, or the app.config file in a vsprvslong project. In this file, insert an element for a <see cref="T:System.Diagnostics.ConsoleTraceListener" />. </para>
<para>The following example adds a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object named configConsoleListener to the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection.</para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;trace autoflush="false" indentsize="4"&gt;
&lt;listeners&gt;
<codeFeaturedElement>&lt;add name="configConsoleListener" </codeFeaturedElement>
<codeFeaturedElement> type="System.Diagnostics.ConsoleTraceListener" /&gt;</codeFeaturedElement>
&lt;/listeners&gt;
&lt;/trace&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
<para>For details about adding trace listeners in the application configuration file, see <format type="text/html"><a href="1394c2c3-6304-46db-87c1-8e8b16f5ad5b">&lt;listeners&gt; Element</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Directs tracing or debugging output to either the standard output or the standard error stream.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ConsoleTraceListener ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to write messages to the <see cref="P:System.Console.Out" /> stream. Its <see cref="P:System.Diagnostics.TraceListener.Name" /> property is initialized to an empty string ("").</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> class with trace output written to the standard output stream.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ConsoleTraceListener (bool useErrorStream);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(bool useErrorStream) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="useErrorStream" Type="System.Boolean" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes a <see cref="T:System.Diagnostics.ConsoleTraceListener" /> object to write messages to either the <see cref="P:System.Console.Out" /> or the <see cref="P:System.Console.Error" /> stream. Its <see cref="P:System.Diagnostics.TraceListener.Name" /> property is initialized to an empty string ("").</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.ConsoleTraceListener" /> class with an option to write trace output to the standard output stream or the standard error stream.</para>
</summary>
<param name="useErrorStream">
<attribution license="cc4" from="Microsoft" modified="false" />true to write tracing and debugging output to the standard error stream; false to write tracing and debugging output to the standard output stream.</param>
</Docs>
</Member>
</Members>
</Type>

149
mcs/class/System/Documentation/en/System.Diagnostics/CorrelationManager.xml Normal file
View File

@@ -0,0 +1,149 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CorrelationManager" FullName="System.Diagnostics.CorrelationManager">
<TypeSignature Language="C#" Value="public class CorrelationManager" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit CorrelationManager extends System.Object" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Traces generated from a single logical operation can be tagged with an operation-unique identity, in order to distinguish them from traces from a different logical operation. For example, it may be useful to group correlated traces by ASP.NET request. The <see cref="T:System.Diagnostics.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. </para>
<para>Logical operations can also be nested. The <see cref="P:System.Diagnostics.CorrelationManager.LogicalOperationStack" /> property exposes the stack of nested logical operation identities. Each call to the <see cref="Overload:System.Diagnostics.CorrelationManager.StartLogicalOperation" /> method pushes a new logical operation identity onto the stack. Each call to the <see cref="M:System.Diagnostics.CorrelationManager.StopLogicalOperation" /> method pops a logical operation identity off the stack. </para>
<block subset="none" type="note">
<para>Logical operation identities are objects, allowing the use of a type for a logical operation identity. </para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Correlates traces that are part of a logical transaction.</para>
</summary>
</Docs>
<Members>
<Member MemberName="ActivityId">
<MemberSignature Language="C#" Value="public Guid ActivityId { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Guid ActivityId" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Guid</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Diagnostics.CorrelationManager.ActivityId" /> property gets and sets the global activity identity in the <see cref="T:System.Runtime.Remoting.Messaging.CallContext" /> for the thread. The <see cref="P:System.Diagnostics.CorrelationManager.ActivityId" /> is used for trace transfer operations in trace listeners that override the <see cref="M:System.Diagnostics.TraceListener.TraceTransfer(System.Diagnostics.TraceEventCache,System.String,System.Int32,System.String,System.Guid)" /> method, such as the <see cref="T:System.Diagnostics.XmlWriterTraceListener" /> class. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the identity for a global activity.</para>
</summary>
</Docs>
</Member>
<Member MemberName="LogicalOperationStack">
<MemberSignature Language="C#" Value="public System.Collections.Stack LogicalOperationStack { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Stack LogicalOperationStack" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Stack</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Each call to the <see cref="Overload:System.Diagnostics.CorrelationManager.StartLogicalOperation" /> method pushes a new logical operation identity onto the <see cref="P:System.Diagnostics.CorrelationManager.LogicalOperationStack" /> property's stack. Each call to the <see cref="M:System.Diagnostics.CorrelationManager.StopLogicalOperation" /> method pops a logical operation identity from the stack.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the logical operation stack from the call context.</para>
</summary>
</Docs>
</Member>
<Member MemberName="StartLogicalOperation">
<MemberSignature Language="C#" Value="public void StartLogicalOperation ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void StartLogicalOperation() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The logical operation is started using an automatically generated GUID for a logical operation identifier.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Starts a logical operation on a thread.</para>
</summary>
</Docs>
</Member>
<Member MemberName="StartLogicalOperation">
<MemberSignature Language="C#" Value="public void StartLogicalOperation (object operationId);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void StartLogicalOperation(object operationId) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="operationId" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <paramref name="operationId" /> parameter can be any object, such as a <see cref="T:System.String" /> that allows the operation to be identified for tracing purposes. The object represented by <paramref name="operationId" /> is added to the <see cref="P:System.Diagnostics.CorrelationManager.LogicalOperationStack" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Starts a logical operation with the specified identity on a thread.</para>
</summary>
<param name="operationId">
<attribution license="cc4" from="Microsoft" modified="false" />An object identifying the operation.</param>
</Docs>
</Member>
<Member MemberName="StopLogicalOperation">
<MemberSignature Language="C#" Value="public void StopLogicalOperation ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void StopLogicalOperation() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The logical operation is halted and the logical operation identity is removed from the <see cref="P:System.Diagnostics.CorrelationManager.LogicalOperationStack" /> property.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Stops the current logical operation.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

176
mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationData.xml Normal file
View File

@@ -0,0 +1,176 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CounterCreationData" FullName="System.Diagnostics.CounterCreationData">
<TypeSignature Language="C#" Value="public class CounterCreationData" Maintainer="auto" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit CounterCreationData extends System.Object" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.TypeConverter("System.Diagnostics.Design.CounterCreationDataConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines the counter type, name, and Help string for a custom counter.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CounterCreationData ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.CounterCreationData" /> class, to a counter of type NumberOfItems32, and with empty name and help strings.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CounterCreationData (string counterName, string counterHelp, System.Diagnostics.PerformanceCounterType counterType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string counterName, string counterHelp, valuetype System.Diagnostics.PerformanceCounterType counterType) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="counterName" Type="System.String" />
<Parameter Name="counterHelp" Type="System.String" />
<Parameter Name="counterType" Type="System.Diagnostics.PerformanceCounterType" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.CounterCreationData" /> class, to a counter of the specified type, using the specified counter name and Help strings.</para>
</summary>
<param name="counterName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the counter, which must be unique within its category. </param>
<param name="counterHelp">
<attribution license="cc4" from="Microsoft" modified="false" />The text that describes the counter's behavior. </param>
<param name="counterType">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.PerformanceCounterType" /> that identifies the counter's behavior. </param>
</Docs>
</Member>
<Member MemberName="CounterHelp">
<MemberSignature Language="C#" Value="public string CounterHelp { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string CounterHelp" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Diagnostics.MonitoringDescription("Description of this counter.")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the custom counter's description.</para>
</summary>
</Docs>
</Member>
<Member MemberName="CounterName">
<MemberSignature Language="C#" Value="public string CounterName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string CounterName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.DefaultValue("")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Diagnostics.MonitoringDescription("Name of this counter.")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the name of the custom counter.</para>
</summary>
</Docs>
</Member>
<Member MemberName="CounterType">
<MemberSignature Language="C#" Value="public System.Diagnostics.PerformanceCounterType CounterType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Diagnostics.PerformanceCounterType CounterType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.ComponentModel.DefaultValue(typeof(System.Diagnostics.PerformanceCounterType), "NumberOfItems32")</AttributeName>
</Attribute>
<Attribute>
<AttributeName>System.Diagnostics.MonitoringDescription("Type of this counter.")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Diagnostics.PerformanceCounterType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>To be added: an object of type 'PerformanceCounterType'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the performance counter type of the custom counter.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

380
mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationDataCollection.xml Normal file
View File

@@ -0,0 +1,380 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CounterCreationDataCollection" FullName="System.Diagnostics.CounterCreationDataCollection">
<TypeSignature Language="C#" Maintainer="auto" Value="public class CounterCreationDataCollection : System.Collections.CollectionBase" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi serializable beforefieldinit CounterCreationDataCollection extends System.Collections.CollectionBase" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Collections.CollectionBase</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a strongly typed collection of <see cref="T:System.Diagnostics.CounterCreationData" /> objects.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CounterCreationDataCollection ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.CounterCreationDataCollection" /> class, with no associated <see cref="T:System.Diagnostics.CounterCreationData" /> instances.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CounterCreationDataCollection (System.Diagnostics.CounterCreationData[] value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Diagnostics.CounterCreationData[] value) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData[]" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.CounterCreationDataCollection" /> class by using the specified array of <see cref="T:System.Diagnostics.CounterCreationData" /> instances.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Diagnostics.CounterCreationData" /> instances with which to initialize this <see cref="T:System.Diagnostics.CounterCreationDataCollection" />. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public CounterCreationDataCollection (System.Diagnostics.CounterCreationDataCollection value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Diagnostics.CounterCreationDataCollection value) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationDataCollection" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.CounterCreationDataCollection" /> class by using the specified collection of <see cref="T:System.Diagnostics.CounterCreationData" /> instances.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterCreationDataCollection" /> that holds <see cref="T:System.Diagnostics.CounterCreationData" /> instances with which to initialize this <see cref="T:System.Diagnostics.CounterCreationDataCollection" />. </param>
</Docs>
</Member>
<Member MemberName="Add">
<MemberSignature Language="C#" Value="public int Add (System.Diagnostics.CounterCreationData value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 Add(class System.Diagnostics.CounterCreationData value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds an instance of the <see cref="T:System.Diagnostics.CounterCreationData" /> class to the collection.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The index of the new <see cref="T:System.Diagnostics.CounterCreationData" /> object.</para>
</returns>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterCreationData" /> object to append to the existing collection. </param>
</Docs>
</Member>
<Member MemberName="AddRange">
<MemberSignature Language="C#" Value="public void AddRange (System.Diagnostics.CounterCreationData[] value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddRange(class System.Diagnostics.CounterCreationData[] value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData[]" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds the specified array of <see cref="T:System.Diagnostics.CounterCreationData" /> instances to the collection.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Diagnostics.CounterCreationData" /> instances to append to the existing collection. </param>
</Docs>
</Member>
<Member MemberName="AddRange">
<MemberSignature Language="C#" Value="public void AddRange (System.Diagnostics.CounterCreationDataCollection value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void AddRange(class System.Diagnostics.CounterCreationDataCollection value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationDataCollection" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Adds the specified collection of <see cref="T:System.Diagnostics.CounterCreationData" /> instances to the collection.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Diagnostics.CounterCreationData" /> instances to append to the existing collection. </param>
</Docs>
</Member>
<Member MemberName="Contains">
<MemberSignature Language="C#" Value="public bool Contains (System.Diagnostics.CounterCreationData value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool Contains(class System.Diagnostics.CounterCreationData value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Determines whether a <see cref="T:System.Diagnostics.CounterCreationData" /> instance exists in the collection.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>true if the specified <see cref="T:System.Diagnostics.CounterCreationData" /> object exists in the collection; otherwise, false.</para>
</returns>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> object to find in the collection. </param>
</Docs>
</Member>
<Member MemberName="CopyTo">
<MemberSignature Language="C#" Value="public void CopyTo (System.Diagnostics.CounterCreationData[] array, int index);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void CopyTo(class System.Diagnostics.CounterCreationData[] array, int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="array" Type="System.Diagnostics.CounterCreationData[]" />
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Copies the elements of the <see cref="T:System.Diagnostics.CounterCreationData" /> to an array, starting at the specified index of the array.</para>
</summary>
<param name="array">
<attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Diagnostics.CounterCreationData" /> instances to add to the collection. </param>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The location at which to add the new instances. </param>
</Docs>
</Member>
<Member MemberName="IndexOf">
<MemberSignature Language="C#" Value="public int IndexOf (System.Diagnostics.CounterCreationData value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance int32 IndexOf(class System.Diagnostics.CounterCreationData value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the index of a <see cref="T:System.Diagnostics.CounterCreationData" /> object in the collection.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The zero-based index of the specified <see cref="T:System.Diagnostics.CounterCreationData" />, if it is found, in the collection; otherwise, -1.</para>
</returns>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> object to locate in the collection. </param>
</Docs>
</Member>
<Member MemberName="Insert">
<MemberSignature Language="C#" Value="public void Insert (int index, System.Diagnostics.CounterCreationData value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Insert(int32 index, class System.Diagnostics.CounterCreationData value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Inserts a <see cref="T:System.Diagnostics.CounterCreationData" /> object into the collection, at the specified index.</para>
</summary>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the location at which the <see cref="T:System.Diagnostics.CounterCreationData" /> is to be inserted. </param>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> to insert into the collection. </param>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public System.Diagnostics.CounterCreationData this[int index] { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Diagnostics.CounterCreationData Item(int32)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.CounterCreationData</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<param name="index">To be added: an object of type 'int'</param>
<summary>To be added</summary>
<value>To be added: an object of type 'CounterCreationData'</value>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="OnInsert">
<MemberSignature Language="C#" Value="protected override void OnInsert (int index, object value);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<param name="index">To be added: an object of type 'int'</param>
<param name="value">To be added: an object of type 'object'</param>
<summary>To be added</summary>
<remarks>To be added</remarks>
</Docs>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OnValidate">
<MemberSignature Language="C#" Value="protected override void OnValidate (object value);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance void OnValidate(object value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Diagnostics.CounterCreationDataCollection.OnValidate(System.Object)" /> method determines whether the object specified in the <paramref name="value" /> parameter is a <see cref="T:System.Diagnostics.CounterCreationData" /> instance. If not, it throws an <see cref="T:System.ArgumentException" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Checks the specified object to determine whether it is a valid <see cref="T:System.Diagnostics.CounterCreationData" /> type.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The object that will be validated.</param>
</Docs>
</Member>
<Member MemberName="Remove">
<MemberSignature Language="C#" Value="public virtual void Remove (System.Diagnostics.CounterCreationData value);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void Remove(class System.Diagnostics.CounterCreationData value) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Removes a <see cref="T:System.Diagnostics.CounterCreationData" /> object from the collection.</para>
</summary>
<param name="value">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> to remove from the collection. </param>
</Docs>
</Member>
</Members>
</Type>

516
mcs/class/System/Documentation/en/System.Diagnostics/CounterSample.xml Normal file
View File

File diff suppressed because it is too large Load Diff

123
mcs/class/System/Documentation/en/System.Diagnostics/CounterSampleCalculator.xml Normal file
View File

@@ -0,0 +1,123 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="CounterSampleCalculator" FullName="System.Diagnostics.CounterSampleCalculator">
<TypeSignature Language="C#" Maintainer="auto" Value="public static class CounterSampleCalculator" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit CounterSampleCalculator extends System.Object" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides a set of utility functions for interpreting performance counter data.</para>
</summary>
</Docs>
<Members>
<Member MemberName="ComputeCounterValue">
<MemberSignature Language="C#" Value="public static float ComputeCounterValue (System.Diagnostics.CounterSample newSample);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig float32 ComputeCounterValue(valuetype System.Diagnostics.CounterSample newSample) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Single</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="newSample" Type="System.Diagnostics.CounterSample" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Diagnostics.CounterSampleCalculator.ComputeCounterValue(System.Diagnostics.CounterSample)" /> method overload returns meaningful results only for performance counters of the following <see cref="T:System.Diagnostics.PerformanceCounterType" />:</para>
<list type="bullet">
<item>
<para>
<see cref="F:System.Diagnostics.PerformanceCounterType.RawFraction" /> </para>
</item>
<item>
<para>
<see cref="F:System.Diagnostics.PerformanceCounterType.NumberOfItems32" />
</para>
</item>
<item>
<para>
<see cref="F:System.Diagnostics.PerformanceCounterType.NumberOfItemsHEX32" />
</para>
</item>
<item>
<para>
<see cref="F:System.Diagnostics.PerformanceCounterType.NumberOfItems64" />
</para>
</item>
<item>
<para>
<see cref="F:System.Diagnostics.PerformanceCounterType.NumberOfItemsHEX64" />
</para>
</item>
</list>
<para>For other counter types, this overload always returns a value of 0 (zero).</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Computes the calculated value of a single raw counter sample.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A floating-point representation of the performance counter's calculated value.</para>
</returns>
<param name="newSample">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterSample" /> that indicates the most recent sample the system has taken. </param>
</Docs>
</Member>
<Member MemberName="ComputeCounterValue">
<MemberSignature Language="C#" Value="public static float ComputeCounterValue (System.Diagnostics.CounterSample oldSample, System.Diagnostics.CounterSample newSample);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig float32 ComputeCounterValue(valuetype System.Diagnostics.CounterSample oldSample, valuetype System.Diagnostics.CounterSample newSample) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO("What's the algorithm?")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Single</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="oldSample" Type="System.Diagnostics.CounterSample" />
<Parameter Name="newSample" Type="System.Diagnostics.CounterSample" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Computes the calculated value of two raw counter samples.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A floating-point representation of the performance counter's calculated value.</para>
</returns>
<param name="oldSample">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterSample" /> that indicates a previous sample the system has taken. </param>
<param name="newSample">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterSample" /> that indicates the most recent sample the system has taken. </param>
</Docs>
</Member>
</Members>
</Type>

53
mcs/class/System/Documentation/en/System.Diagnostics/DataReceivedEventArgs.xml Normal file
View File

@@ -0,0 +1,53 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataReceivedEventArgs" FullName="System.Diagnostics.DataReceivedEventArgs">
<TypeSignature Language="C#" Value="public class DataReceivedEventArgs : EventArgs" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DataReceivedEventArgs extends System.EventArgs" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.EventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To asynchronously collect the redirected <see cref="P:System.Diagnostics.Process.StandardOutput" /> or <see cref="P:System.Diagnostics.Process.StandardError" /> stream output of a process, you must create a method that handles the redirected stream output events. The event-handler method is called when the process writes to the redirected stream. The event delegate calls your event handler with an instance of <see cref="T:System.Diagnostics.DataReceivedEventArgs" />. The <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property contains the text line that the process wrote to the redirected stream.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for the <see cref="E:System.Diagnostics.Process.OutputDataReceived" /> and <see cref="E:System.Diagnostics.Process.ErrorDataReceived" /> events.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Data">
<MemberSignature Language="C#" Value="public string Data { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Data" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you redirect the <see cref="P:System.Diagnostics.Process.StandardOutput" /> or <see cref="P:System.Diagnostics.Process.StandardError" /> stream of a <see cref="T:System.Diagnostics.Process" /> to your event handler, an event is raised each time the process writes a line to the redirected stream. The <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property is the line that the <see cref="T:System.Diagnostics.Process" /> wrote to the redirected output stream. Your event handler can use the <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property to filter process output or write output to an alternate location. For example, you might create an event handler that stores all error output lines into a designated error log file.</para>
<para>A line is defined as a sequence of characters followed by a line feed ("\n") or a carriage return immediately followed by a line feed ("\r\n"). The line characters are encoded using the default system ANSI code page. The <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property does not include the terminating carriage return or line feed.</para>
<para>When the redirected stream is closed, a null line is sent to the event handler. Ensure your event handler checks the <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property appropriately before accessing it. For example, you can use the static method <see cref="M:System.String.IsNullOrEmpty(System.String)" /> to validate the <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property in your event handler.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the line of characters that was written to a redirected <see cref="T:System.Diagnostics.Process" /> output stream.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

34
mcs/class/System/Documentation/en/System.Diagnostics/DataReceivedEventHandler.xml Normal file
View File

@@ -0,0 +1,34 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DataReceivedEventHandler" FullName="System.Diagnostics.DataReceivedEventHandler">
<TypeSignature Language="C#" Value="public delegate void DataReceivedEventHandler(object sender, DataReceivedEventArgs e);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed DataReceivedEventHandler extends System.MulticastDelegate" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Diagnostics.DataReceivedEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">To be added.</param>
<param name="e">To be added.</param>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you create a <see cref="T:System.Diagnostics.DataReceivedEventHandler" /> delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see <format type="text/html"><a href="d98fd58b-fa4f-4598-8378-addf4355a115">Events and Delegates</a></format>.</para>
<para>To asynchronously collect the redirected <see cref="P:System.Diagnostics.Process.StandardOutput" /> or <see cref="P:System.Diagnostics.Process.StandardError" /> stream output of a process, add your event handler to the <see cref="E:System.Diagnostics.Process.OutputDataReceived" /> or <see cref="E:System.Diagnostics.Process.ErrorDataReceived" /> event. These events are raised each time the process writes a line to the corresponding redirected stream. When the redirected stream is closed, a null line is sent to the event handler. Ensure that your event handler checks for this condition before accessing the <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property. For example, you can use the static method <see cref="M:System.String.IsNullOrEmpty(System.String)" /> to validate the <see cref="P:System.Diagnostics.DataReceivedEventArgs.Data" /> property in your event handler.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that will handle the <see cref="E:System.Diagnostics.Process.OutputDataReceived" /> event or <see cref="E:System.Diagnostics.Process.ErrorDataReceived" /> event of a <see cref="T:System.Diagnostics.Process" />.</para>
</summary>
</Docs>
</Type>

1299
mcs/class/System/Documentation/en/System.Diagnostics/Debug.xml Normal file
View File

File diff suppressed because it is too large Load Diff

246
mcs/class/System/Documentation/en/System.Diagnostics/DefaultTraceListener.xml Normal file
View File

@@ -0,0 +1,246 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DefaultTraceListener" FullName="System.Diagnostics.DefaultTraceListener">
<TypeSignature Language="C#" Maintainer="auto" Value="public class DefaultTraceListener : System.Diagnostics.TraceListener" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi DefaultTraceListener extends System.Diagnostics.TraceListener" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Diagnostics.TraceListener</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An instance of this class is automatically added to the <see cref="P:System.Diagnostics.Debug.Listeners" /> and <see cref="P:System.Diagnostics.Trace.Listeners" /> collections. Explicitly adding a second <see cref="T:System.Diagnostics.DefaultTraceListener" /> causes duplicate messages in the debugger output window and duplicate message boxes for asserts.</para>
<para>By default, the <see cref="M:System.Diagnostics.DefaultTraceListener.Write(System.String)" /> and <see cref="M:System.Diagnostics.DefaultTraceListener.WriteLine(System.String)" /> methods emit the message to the Win32 OutputDebugString function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)" /> method. For information about the OutputDebugString function, see the Platform SDK or MSDN.</para>
<para>The <see cref="M:System.Diagnostics.DefaultTraceListener.Fail(System.String)" /> method, by default, displays a message box when the application is running in a user interface mode; it also emits the message using <see cref="M:System.Diagnostics.DefaultTraceListener.WriteLine(System.String)" />.</para>
<block subset="none" type="note">
<para>The display of the message box for <see cref="Overload:System.Diagnostics.Debug.Assert" /> and <see cref="Overload:System.Diagnostics.Debug.Fail" /> method calls depends on the presence of the <see cref="T:System.Diagnostics.DefaultTraceListener" />. If the <see cref="T:System.Diagnostics.DefaultTraceListener" /> is not in the <see cref="P:System.Diagnostics.Trace.Listeners" /> collection, the message box is not displayed. The <see cref="T:System.Diagnostics.DefaultTraceListener" /> can be removed by the <format type="text/html"><a href="b44732a8-271f-4a06-ba9e-fe3298d6f192">&lt;clear&gt; element</a></format>, by the <format type="text/html"><a href="9a5cd1b5-be1a-485f-8f0c-2890ad3ef3e0">&lt;remove&gt; element</a></format>, or by calling the <see cref="M:System.Diagnostics.TraceListenerCollection.Clear" /> method on the <see cref="P:System.Diagnostics.Trace.Listeners" /> property (System.Diagnostics.Trace.Listeners.Clear()).</para>
</block>
<para>You must enable tracing or debugging to use a trace listener. The following syntax is compiler specific. If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.</para>
<list type="bullet">
<item>
<para>To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or add #define DEBUG to the top of your file. In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.</para>
</item>
<item>
<para>To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. In Visual Basic, add the /d:TRACE=True flag to the compiler command line.</para>
</item>
</list>
<para>To add a trace listener, edit the configuration file that corresponds to the name of your application. Within this file, you can add a listener, set its type and set its parameters, remove a listener, or clear all the listeners previously set by the application. The configuration file should be formatted similar to the following example: </para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;trace autoflush="false" indentsize="4"&gt;
&lt;listeners&gt;
&lt;remove name="Default" /&gt;
&lt;add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\myListener.log" /&gt;
&lt;/listeners&gt;
&lt;/trace&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides the default output methods and behavior for tracing.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DefaultTraceListener ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>Constructs a new instance of the <see cref="T:System.Diagnostics.DefaultTraceListener" /> class, with a <see cref="P:System.Diagnostics.TraceListener.Name" /> value of <c>Default</c>.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DefaultTraceListener" /> class with "Default" as its <see cref="P:System.Diagnostics.TraceListener.Name" /> property value.</para>
</summary>
</Docs>
</Member>
<Member MemberName="AssertUiEnabled">
<MemberSignature Language="C#" Value="public bool AssertUiEnabled { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool AssertUiEnabled" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>Whether or not a GUI should be used when <see cref="M:System.Diagnostics.TraceListener.Fail" /> is called.</value>
<remarks>
<para>If <see langword="true" />, calls to <see cref="M:System.Diagnostics.TraceListener.Fail" /> should appear in a GUI dialog box.</para>
<para>This is currently ignored by Mono.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets a value indicating whether the application is running in user-interface mode.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Fail">
<MemberSignature Language="C#" Value="public override void Fail (string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Fail(string message) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, this method sends the <paramref name="message" /> parameter and a stack trace to a message box (when the application runs in user-interface mode) and to the <see cref="T:System.Diagnostics.DefaultTraceListener" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Emits or displays a message and a stack trace for an assertion that always fails.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The message to emit or display. </param>
</Docs>
</Member>
<Member MemberName="Fail">
<MemberSignature Language="C#" Value="public override void Fail (string message, string detailMessage);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Fail(string message, string detailMessage) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="message" Type="System.String" />
<Parameter Name="detailMessage" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>By default, this method sends the <paramref name="message" /> parameter, the <paramref name="detailMessage" /> parameter, and a stack trace to a message box (when the application runs in user-interface mode) and to the <see cref="T:System.Diagnostics.DefaultTraceListener" /> instance.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Emits or displays detailed messages and a stack trace for an assertion that always fails.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The message to emit or display. </param>
<param name="detailMessage">
<attribution license="cc4" from="Microsoft" modified="false" />The detailed message to emit or display. </param>
</Docs>
</Member>
<Member MemberName="LogFileName">
<MemberSignature Language="C#" Value="public string LogFileName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string LogFileName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.MonoTODO</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<value>To be added: an object of type 'string'</value>
<remarks>When set to a non-empty string, all debug and trace messages are appended to the specified file.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the name of a log file to write trace or debug messages to.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Write">
<MemberSignature Language="C#" Value="public override void Write (string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void Write(string message) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For information about the Win32 OutputDebugString debugging function, see "OutputDebugString" in the Platform SDK or MSDN.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the output to the OutputDebugString function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)" /> method.</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The message to write to OutputDebugString and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)" />. </param>
</Docs>
</Member>
<Member MemberName="WriteLine">
<MemberSignature Language="C#" Value="public override void WriteLine (string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void WriteLine(string message) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default line terminator is a carriage return followed by a line feed (\r\n).</para>
<para>For information about the Win32 OutputDebugString debugging function, see the Platform SDK or MSDN.</para>
<para>This method sets the <see cref="P:System.Diagnostics.TraceListener.NeedIndent" /> property to true.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes the output to the OutputDebugString function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)" /> method, followed by a carriage return and line feed (\r\n).</para>
</summary>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The message to write to OutputDebugString and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)" />. </param>
</Docs>
</Member>
</Members>
</Type>

472
mcs/class/System/Documentation/en/System.Diagnostics/DelimitedListTraceListener.xml Normal file
View File

@@ -0,0 +1,472 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DelimitedListTraceListener" FullName="System.Diagnostics.DelimitedListTraceListener">
<TypeSignature Language="C#" Value="public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DelimitedListTraceListener extends System.Diagnostics.TextWriterTraceListener" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Diagnostics.TextWriterTraceListener</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The trace output is in a delimited text format that uses the delimiter specified by the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property. The delimiter is used to terminate each field in a line of output. For example, to display the trace output in a Microsoft Excel spreadsheet, you might specify a comma (",") as a delimiter and create a comma-separated value (CSV) file.</para>
<para>You can enable or disable a <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> through the application configuration file and then use the configured <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> in your application. Alternately, you can create a <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> in your code.</para>
<block subset="none" type="note">
<para>The <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> delimits only text that is emitted by using the methods that have names starting with the word Trace, such as <see cref="Overload:System.Diagnostics.DelimitedListTraceListener.TraceEvent" /> or <see cref="M:System.Diagnostics.Trace.TraceWarning(System.String)" />. Trace data that is emitted by using the <see cref="Overload:System.Diagnostics.Debug.Write" /> and <see cref="Overload:System.Diagnostics.TextWriterTraceListener.WriteLine" /> methods is not delimited.</para>
</block>
<para>To configure a <see cref="T:System.Diagnostics.DelimitedListTraceListener" />, edit the configuration file that corresponds to the name of your application. In this file, you can add a listener, set the properties for a listener, or remove a listener. The configuration file should be formatted as shown in the following example: </para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;trace autoflush="false" indentsize="4"&gt;
&lt;listeners&gt;
&lt;add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
delimiter=","
initializeData="delimitedOutput.csv"
traceOutputOptions="ProcessId, DateTime" /&gt;
&lt;/listeners&gt;
&lt;/trace&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
<block subset="none" type="note">
<para>If you try to write to a file that is in use or unavailable, the file name is automatically prefixed by a GUID. </para>
</block>
<block subset="none" type="note">
<para>Listeners are intended to be used by methods of the <see cref="T:System.Diagnostics.Debug" />, <see cref="T:System.Diagnostics.Trace" />, and <see cref="T:System.Diagnostics.TraceSource" /> classes to write trace information. Listener methods, except for constructors, should not be called directly from application code.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Directs tracing or debugging output to a text writer, such as a stream writer, or to a stream, such as a file stream.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (System.IO.Stream stream);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="stream" Type="System.IO.Stream" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the <see cref="P:System.Diagnostics.TraceListener.Name" /> property to an empty string ("").</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified output stream. </para>
</summary>
<param name="stream">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> to receive the output.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (System.IO.TextWriter writer);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.TextWriter writer) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="writer" Type="System.IO.TextWriter" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the <see cref="P:System.Diagnostics.TraceListener.Name" /> property to an empty string ("").</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified text writer. </para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> to receive the output.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (string fileName);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string fileName) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="fileName" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the <see cref="P:System.Diagnostics.TraceListener.Name" /> property to an empty string ("").</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified file. </para>
</summary>
<param name="fileName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the file to receive the output.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (System.IO.Stream stream, string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.Stream stream, string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="stream" Type="System.IO.Stream" />
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the <see cref="P:System.Diagnostics.TraceListener.Name" /> property to the value of the <paramref name="name" /> parameter, or to an empty string ("") if the <paramref name="name" /> parameter is null. The <see cref="P:System.Diagnostics.TraceListener.Name" /> property can be used as an index into the Listeners collection to programmatically change the properties for the listener. For example, the following code sets the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property for the instance of <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> that has the name "delimListener": </para>
<code>((DelimitedListTraceListener)Trace.Listeners["delimListener"]).Delimiter = ":"</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified output stream and has the specified name. </para>
</summary>
<param name="stream">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> to receive the output.</param>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the new instance of the trace listener. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (System.IO.TextWriter writer, string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.IO.TextWriter writer, string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="writer" Type="System.IO.TextWriter" />
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes the <see cref="P:System.Diagnostics.TraceListener.Name" /> property to the value of the <paramref name="name" /> parameter, or to an empty string ("") if the <paramref name="name" /> parameter is null. The <see cref="P:System.Diagnostics.TraceListener.Name" /> property can be used as an index into the Listeners collection to programmatically change the properties for the listener. For example the following code sets the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property for the instance of <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> that has the name "delimListener": </para>
<code>((DelimitedListTraceListener)Trace.Listeners["delimListener"]).Delimiter = ":"</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified text writer and has the specified name. </para>
</summary>
<param name="writer">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> to receive the output.</param>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the new instance of the trace listener. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DelimitedListTraceListener (string fileName, string name);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string fileName, string name) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="fileName" Type="System.String" />
<Parameter Name="name" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This constructor initializes a new instance of the <see cref="T:System.IO.StreamWriter" /> class for the specified file on the specified path, using <see cref="P:System.Text.Encoding.UTF8" /> encoding. If the file exists, it is appended to. If the file does not exist, a new file is created.</para>
<block subset="none" type="note">
<para>To reduce the chance of an exception, any character that might invalidate the output is replaced with a "?" character.</para>
</block>
<para>The <see cref="P:System.Diagnostics.TraceListener.Name" /> property is set to the value of the <paramref name="name" /> parameter, or to an empty string ("") if the <paramref name="name" /> parameter is null. The <see cref="P:System.Diagnostics.TraceListener.Name" /> property can be used as an index into the Listeners collection to programmatically change the properties for the listener. For example, the following code sets the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property for the instance of <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> that has the name "delimListener": </para>
<code>((DelimitedListTraceListener)Trace.Listeners["delimListener"]).Delimiter = ":"</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> class that writes to the specified file and has the specified name. </para>
</summary>
<param name="fileName">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the file to receive the output. </param>
<param name="name">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the new instance of the trace listener. </param>
</Docs>
</Member>
<Member MemberName="Delimiter">
<MemberSignature Language="C#" Value="public string Delimiter { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Delimiter" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The default delimiter is ";" (semicolon). The following configuration file example shows the setting of the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property using the delimiter attribute in a configuration file:</para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;trace autoflush="false" indentsize="4"&gt;
&lt;listeners&gt;
&lt;add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
delimiter=":"
initializeData="delimitedOutput.txt"
traceOutputOptions="ProcessId, DateTime" /&gt;
&lt;remove name="Default" /&gt;
&lt;/listeners&gt;
&lt;/trace&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;
</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the delimiter for the delimited list.</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetSupportedAttributes">
<MemberSignature Language="C#" Value="protected override string[] GetSupportedAttributes ();" />
<MemberSignature Language="ILAsm" Value=".method familyorassemblyhidebysig virtual instance string[] GetSupportedAttributes() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A custom attribute is an attribute that is not inherited from the base class that can be used to set a property for the class. The custom attribute for <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> is used to set the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property. The following configuration file example shows the use of the delimiter attribute to set the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property:</para>
<code>&lt;configuration&gt;
&lt;system.diagnostics&gt;
&lt;trace autoflush="false" indentsize="4"&gt;
&lt;listeners&gt;
&lt;add name="delimitedListener"
type="System.Diagnostics.DelimitedListTraceListener"
<codeFeaturedElement> delimiter=":" </codeFeaturedElement>
initializeData="delimitedOutput.txt"
traceOutputOptions="ProcessId, DateTime" /&gt;
&lt;remove name="Default" /&gt;
&lt;/listeners&gt;
&lt;/trace&gt;
&lt;/system.diagnostics&gt;
&lt;/configuration&gt;</code>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Returns the custom configuration file attribute supported by the delimited trace listener.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A string array that contains the single value "delimiter".</para>
</returns>
</Docs>
</Member>
<Member MemberName="TraceData">
<MemberSignature Language="C#" Value="public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void TraceData(class System.Diagnostics.TraceEventCache eventCache, string source, valuetype System.Diagnostics.TraceEventType eventType, int32 id, object data) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="eventCache" Type="System.Diagnostics.TraceEventCache" />
<Parameter Name="source" Type="System.String" />
<Parameter Name="eventType" Type="System.Diagnostics.TraceEventType" />
<Parameter Name="id" Type="System.Int32" />
<Parameter Name="data" Type="System.Object" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The values of the <paramref name="source" />, <paramref name="eventType" />, and <paramref name="id" /> parameters are written as a header. The data object is converted to a string using the ToString method of the object. The <paramref name="eventCache" /> data is written as a footer whose content depends on the value of the <see cref="P:System.Diagnostics.TraceListener.TraceOutputOptions" /> property.</para>
<block subset="none" type="note">
<para>The <see cref="Overload:System.Diagnostics.DelimitedListTraceListener.TraceData" /> method is not intended to be called by application code. It is called by methods of the <see cref="T:System.Diagnostics.Debug" />, <see cref="T:System.Diagnostics.Trace" />, and <see cref="T:System.Diagnostics.TraceSource" /> classes to write trace data.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes trace information, a data object, and event information to the output file or stream.</para>
</summary>
<param name="eventCache">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceEventCache" /> object that contains the current process ID, thread ID, and stack trace information.</param>
<param name="source">
<attribution license="cc4" from="Microsoft" modified="false" />A name used to identify the output, typically the name of the application that generated the trace event.</param>
<param name="eventType">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Diagnostics.TraceEventType" /> values specifying the type of event that has caused the trace.</param>
<param name="id">
<attribution license="cc4" from="Microsoft" modified="false" />A numeric identifier for the event.</param>
<param name="data">
<attribution license="cc4" from="Microsoft" modified="false" />A data object to write to the output file or stream.</param>
</Docs>
</Member>
<Member MemberName="TraceData">
<MemberSignature Language="C#" Value="public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object[] data);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void TraceData(class System.Diagnostics.TraceEventCache eventCache, string source, valuetype System.Diagnostics.TraceEventType eventType, int32 id, object[] data) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="eventCache" Type="System.Diagnostics.TraceEventCache" />
<Parameter Name="source" Type="System.String" />
<Parameter Name="eventType" Type="System.Diagnostics.TraceEventType" />
<Parameter Name="id" Type="System.Int32" />
<Parameter Name="data" Type="System.Object[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The values of the <paramref name="source" />, <paramref name="eventType" />, and <paramref name="id" /> parameters are written as a header. The data objects are converted to strings using the ToString method of each object. The <paramref name="eventCache" /> data is written as a footer whose content depends on the value of the <see cref="P:System.Diagnostics.TraceListener.TraceOutputOptions" /> property.</para>
<block subset="none" type="note">
<para>The <see cref="Overload:System.Diagnostics.DelimitedListTraceListener.TraceData" /> method is not intended to be called by application code. It is called by methods of the <see cref="T:System.Diagnostics.Debug" />, <see cref="T:System.Diagnostics.Trace" />, and <see cref="T:System.Diagnostics.TraceSource" /> classes to write trace data.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes trace information, an array of data objects, and event information to the output file or stream.</para>
</summary>
<param name="eventCache">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceEventCache" /> object that contains the current process ID, thread ID, and stack trace information.</param>
<param name="source">
<attribution license="cc4" from="Microsoft" modified="false" />A name used to identify the output, typically the name of the application that generated the trace event.</param>
<param name="eventType">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Diagnostics.TraceEventType" /> values specifying the type of event that has caused the trace.</param>
<param name="id">
<attribution license="cc4" from="Microsoft" modified="false" />A numeric identifier for the event.</param>
<param name="data">
<attribution license="cc4" from="Microsoft" modified="false" />An array of data objects to write to the output file or stream.</param>
</Docs>
</Member>
<Member MemberName="TraceEvent">
<MemberSignature Language="C#" Value="public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void TraceEvent(class System.Diagnostics.TraceEventCache eventCache, string source, valuetype System.Diagnostics.TraceEventType eventType, int32 id, string message) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="eventCache" Type="System.Diagnostics.TraceEventCache" />
<Parameter Name="source" Type="System.String" />
<Parameter Name="eventType" Type="System.Diagnostics.TraceEventType" />
<Parameter Name="id" Type="System.Int32" />
<Parameter Name="message" Type="System.String" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The values of the <paramref name="source" />, <paramref name="eventType" />, and <paramref name="id" /> parameters are written as a header, followed by the <paramref name="message" /> data. The <paramref name="eventCache" /> data is written as a footer whose content depends on the value of the <see cref="P:System.Diagnostics.TraceListener.TraceOutputOptions" /> property.</para>
<block subset="none" type="note">
<para>The <see cref="Overload:System.Diagnostics.DelimitedListTraceListener.TraceEvent" /> method is not intended to be called by application code. It is called by methods of the <see cref="T:System.Diagnostics.Debug" />, <see cref="T:System.Diagnostics.Trace" />, and <see cref="T:System.Diagnostics.TraceSource" /> classes to write trace data.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes trace information, a message, and event information to the output file or stream.</para>
</summary>
<param name="eventCache">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceEventCache" /> object that contains the current process ID, thread ID, and stack trace information.</param>
<param name="source">
<attribution license="cc4" from="Microsoft" modified="false" />A name used to identify the output, typically the name of the application that generated the trace event.</param>
<param name="eventType">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Diagnostics.TraceEventType" /> values specifying the type of event that has caused the trace.</param>
<param name="id">
<attribution license="cc4" from="Microsoft" modified="false" />A numeric identifier for the event.</param>
<param name="message">
<attribution license="cc4" from="Microsoft" modified="false" />The trace message to write to the output file or stream.</param>
</Docs>
</Member>
<Member MemberName="TraceEvent">
<MemberSignature Language="C#" Value="public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, object[] args);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance void TraceEvent(class System.Diagnostics.TraceEventCache eventCache, string source, valuetype System.Diagnostics.TraceEventType eventType, int32 id, string format, object[] args) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="eventCache" Type="System.Diagnostics.TraceEventCache" />
<Parameter Name="source" Type="System.String" />
<Parameter Name="eventType" Type="System.Diagnostics.TraceEventType" />
<Parameter Name="id" Type="System.Int32" />
<Parameter Name="format" Type="System.String" />
<Parameter Name="args" Type="System.Object[]">
<Attributes>
<Attribute>
<AttributeName>System.ParamArray</AttributeName>
</Attribute>
</Attributes>
</Parameter>
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The values of the <paramref name="source" />, <paramref name="eventType" />, and <paramref name="id" /> parameters are written as a header. The <paramref name="args" /> object array is converted to a string using the <see cref="M:System.String.Format(System.String,System.Object[])" /> method, passing the <paramref name="format" /> string and <paramref name="args" /> array to format the string as the message portion of the trace. The <paramref name="eventCache" /> data is written as a footer whose content depends on the value of the <see cref="P:System.Diagnostics.TraceListener.TraceOutputOptions" /> property.</para>
<block subset="none" type="note">
<para>The <see cref="Overload:System.Diagnostics.DelimitedListTraceListener.TraceEvent" /> method is not intended to be called by application code. It is called by methods of the <see cref="T:System.Diagnostics.Debug" />, <see cref="T:System.Diagnostics.Trace" />, and <see cref="T:System.Diagnostics.TraceSource" /> classes to write trace data.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Writes trace information, a formatted array of objects, and event information to the output file or stream.</para>
</summary>
<param name="eventCache">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceEventCache" /> object that contains the current process ID, thread ID, and stack trace information.</param>
<param name="source">
<attribution license="cc4" from="Microsoft" modified="false" />A name used to identify the output, typically the name of the application that generated the trace event.</param>
<param name="eventType">
<attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Diagnostics.TraceEventType" /> values specifying the type of event that has caused the trace.</param>
<param name="id">
<attribution license="cc4" from="Microsoft" modified="false" />A numeric identifier for the event.</param>
<param name="format">
<attribution license="cc4" from="Microsoft" modified="false" />A format string that contains zero or more format items that correspond to objects in the <paramref name="args" /> array.</param>
<param name="args">
<attribution license="cc4" from="Microsoft" modified="false" />An array containing zero or more objects to format.</param>
</Docs>
</Member>
</Members>
</Type>

99
mcs/class/System/Documentation/en/System.Diagnostics/DiagnosticsConfigurationHandler.xml Normal file
View File

@@ -0,0 +1,99 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="DiagnosticsConfigurationHandler" FullName="System.Diagnostics.DiagnosticsConfigurationHandler">
<TypeSignature Language="C#" Maintainer="auto" Value="public class DiagnosticsConfigurationHandler : System.Configuration.IConfigurationSectionHandler" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit DiagnosticsConfigurationHandler extends System.Object implements class 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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Configuration.IConfigurationSectionHandler</InterfaceName>
</Interface>
</Interfaces>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete("This class is obsoleted")</AttributeName>
</Attribute>
</Attributes>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Diagnostics.DiagnosticsConfigurationHandler" /> method is a section handler that participates in the resolution of configuration settings in the <format type="text/html"><a href="3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2">&lt;system.diagnostics&gt; Element</a></format> portion of configuration files.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Handles the diagnostics section of configuration files.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DiagnosticsConfigurationHandler ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<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>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.DiagnosticsConfigurationHandler" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Create">
<MemberSignature Language="C#" Value="public virtual object Create (object parent, object configContext, System.Xml.XmlNode section);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object Create(object parent, object configContext, class System.Xml.XmlNode section) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<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>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Diagnostics.DiagnosticsConfigurationHandler.Create(System.Object,System.Object,System.Xml.XmlNode)" /> method populates a <see cref="T:System.Collections.Hashtable" /> with the values obtained from the <format type="text/html"><a href="3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2">&lt;system.diagnostics&gt; Element</a></format> section of a configuration file and returns the hashtable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Parses the configuration settings for the <format type="text/html"><a href="3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2">&lt;system.diagnostics&gt; Element</a></format> section of configuration files.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A new configuration object, in the form of a <see cref="T:System.Collections.Hashtable" />.</para>
</returns>
<param name="parent">
<attribution license="cc4" from="Microsoft" modified="false" />The object inherited from the parent path</param>
<param name="configContext">
<attribution license="cc4" from="Microsoft" modified="false" />Reserved. Used in ASP.NET to convey the virtual path of the configuration being evaluated.</param>
<param name="section">
<attribution license="cc4" from="Microsoft" modified="false" />The root XML node at the section to handle.</param>
</Docs>
</Member>
</Members>
</Type>

90
mcs/class/System/Documentation/en/System.Diagnostics/EntryWrittenEventArgs.xml Normal file
View File

@@ -0,0 +1,90 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EntryWrittenEventArgs" FullName="System.Diagnostics.EntryWrittenEventArgs">
<TypeSignature Language="C#" Maintainer="auto" Value="public class EntryWrittenEventArgs : EventArgs" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit EntryWrittenEventArgs extends System.EventArgs" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.EventArgs</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides data for the <see cref="E:System.Diagnostics.EventLog.EntryWritten" /> event.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public EntryWrittenEventArgs ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.EntryWrittenEventArgs" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public EntryWrittenEventArgs (System.Diagnostics.EventLogEntry entry);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Diagnostics.EventLogEntry entry) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters>
<Parameter Name="entry" Type="System.Diagnostics.EventLogEntry" />
</Parameters>
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.EntryWrittenEventArgs" /> class with the specified event log entry.</para>
</summary>
<param name="entry">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Diagnostics.EventLogEntry" /> that represents the entry that was written. </param>
</Docs>
</Member>
<Member MemberName="Entry">
<MemberSignature Language="C#" Value="public System.Diagnostics.EventLogEntry Entry { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Diagnostics.EventLogEntry Entry" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntry</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'EventLogEntry'</value>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the event log entry that was written to the log.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

37
mcs/class/System/Documentation/en/System.Diagnostics/EntryWrittenEventHandler.xml Normal file
View File

@@ -0,0 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EntryWrittenEventHandler" FullName="System.Diagnostics.EntryWrittenEventHandler">
<TypeSignature Language="C#" Maintainer="auto" Value="public delegate void EntryWrittenEventHandler(object sender, EntryWrittenEventArgs e);" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed EntryWrittenEventHandler extends System.MulticastDelegate" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Delegate</BaseTypeName>
</Base>
<Parameters>
<Parameter Name="sender" Type="System.Object" />
<Parameter Name="e" Type="System.Diagnostics.EntryWrittenEventArgs" />
</Parameters>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Docs>
<param name="sender">To be added.</param>
<param name="e">To be added.</param>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When you create an <see cref="T:System.Diagnostics.EntryWrittenEventHandler" /> delegate, you identify the method that will handle the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler delegates, see <format type="text/html"><a href="D98FD58B-FA4F-4598-8378-ADDF4355A115">[&lt;topic://cpconEventsDelegates&gt;]</a></format>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents the method that will handle the <see cref="E:System.Diagnostics.EventLog.EntryWritten" /> event of an <see cref="T:System.Diagnostics.EventLog" />.</para>
</summary>
</Docs>
<Members />
</Type>

173
mcs/class/System/Documentation/en/System.Diagnostics/EventInstance.xml Normal file
View File

@@ -0,0 +1,173 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EventInstance" FullName="System.Diagnostics.EventInstance">
<TypeSignature Language="C#" Value="public class EventInstance" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit EventInstance extends System.Object" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use <see cref="T:System.Diagnostics.EventInstance" /> to write an event log entry with a resource identifier rather than a string value. To write an event log entry, initialize the <see cref="P:System.Diagnostics.EventInstance.InstanceId" /> property and pass the instance to the <see cref="Overload:System.Diagnostics.EventLog.WriteEvent" /> method. The Event Viewer uses the instance identifier to find and display the corresponding string from the localized resource file based on current language settings. You must register the event source with the corresponding resource file before you write events using resource identifiers.</para>
<para>When writing events, you can set the <see cref="P:System.Diagnostics.EventInstance.EntryType" /> property to specify the icon that the Event Viewer displays for the entry. You can also specify a <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> property to specify the category that the Event Viewer displays for the entry.</para>
<para>The Event Viewer uses the category to filter events written by an event source. The Event Viewer can display the category as a numeric value, or it can use the category as a resource identifier to display a localized category string.</para>
<para>To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> to a resource identifier in the category resource file. If the event source does not have a configured category resource file, or the specified <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> does not index a string in the category resource file, and then the Event Viewer displays the numeric category value for that entry. Configure the category resource file, along with the number of category strings in the resource file, using the <see cref="T:System.Diagnostics.EventLogInstaller" /> or the <see cref="T:System.Diagnostics.EventSourceCreationData" /> class.</para>
<para>You must register a source for an event log before using <see cref="T:System.Diagnostics.EventInstance" /> to write an event with the <see cref="Overload:System.Diagnostics.EventLog.WriteEvent" /> method. The source must be configured for writing localized entries to the log and the source must define at least a message resource file. </para>
<para>Create the new event source during the installation of your application. This allows time for the operating system to refresh its list of registered event sources and their configurations. If the operating system has not refreshed its list of event sources, and you attempt to write an event with the new source, the write operation will fail. You can configure a new source using an <see cref="T:System.Diagnostics.EventLogInstaller" />, or using the <see cref="Overload:System.Diagnostics.EventLog.CreateEventSource" /> method. You must have administrative rights on the computer to create a new event source.</para>
<para>For details about defining event messages and building event log resource files, see the "Message Compiler" topic in the Platform SDK documentation at <see cref="http://msdn.microsoft.com">http://msdn.microsoft.com</see>.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Represents language-neutral information for an event log entry.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public EventInstance (long instanceId, int categoryId);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int64 instanceId, int32 categoryId) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="instanceId" Type="System.Int64" />
<Parameter Name="categoryId" Type="System.Int32" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To write an informational entry to an event log, initialize an <see cref="T:System.Diagnostics.EventInstance" /> and pass it to the <see cref="Overload:System.Diagnostics.EventLog.WriteEvent" /> method. Set the <paramref name="instanceId" /> to the resource identifier of the event message in the corresponding <see cref="P:System.Diagnostics.EventSourceCreationData.MessageResourceFile" /> property for the source. Set the <paramref name="categoryId" /> to a numeric category value, or the resource identifier of the event category in the <see cref="P:System.Diagnostics.EventSourceCreationData.CategoryResourceFile" /> property for the source; set the <paramref name="categoryId" /> to zero for no event category. The <see cref="P:System.Diagnostics.EventInstance.EntryType" /> property for the new instance is set to <see cref="F:System.Diagnostics.EventLogEntryType.Information" /> by default.</para>
<para>The Event Viewer uses the resource identifiers to display the corresponding strings from the localized resource files for the source. You must register the source with the corresponding resource files before you can write events using resource identifiers.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.EventInstance" /> class using the specified resource identifiers for the localized message and category text of the event entry.</para>
</summary>
<param name="instanceId">
<attribution license="cc4" from="Microsoft" modified="false" />A resource identifier that corresponds to a string defined in the message resource file of the event source.</param>
<param name="categoryId">
<attribution license="cc4" from="Microsoft" modified="false" />A resource identifier that corresponds to a string defined in the category resource file of the event source, or zero to specify no category for the event. </param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public EventInstance (long instanceId, int categoryId, System.Diagnostics.EventLogEntryType entryType);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int64 instanceId, int32 categoryId, valuetype System.Diagnostics.EventLogEntryType entryType) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="instanceId" Type="System.Int64" />
<Parameter Name="categoryId" Type="System.Int32" />
<Parameter Name="entryType" Type="System.Diagnostics.EventLogEntryType" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To write an entry to an event log, initialize an <see cref="T:System.Diagnostics.EventInstance" /> and pass it to the <see cref="Overload:System.Diagnostics.EventLog.WriteEvent" /> method. Set the <paramref name="instanceId" /> to the resource identifier of the event message in the corresponding <see cref="P:System.Diagnostics.EventSourceCreationData.MessageResourceFile" /> property for the source. Set the <paramref name="categoryId" /> to a numeric category value, or the resource identifier of the event category in the <see cref="P:System.Diagnostics.EventSourceCreationData.CategoryResourceFile" /> property for the source; set the <paramref name="categoryId" /> to zero for no event category.</para>
<para>The Event Viewer uses the resource identifiers to display the corresponding strings from the localized resource files for the source. You must register the source with the corresponding resource files before you can write events using resource identifiers.</para>
<para>Set the <paramref name="entryType" /> to one of the pre-defined entry types. The Event Viewer uses the event type to determine which icon to display in the list view of the event log.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.Diagnostics.EventInstance" /> class using the specified resource identifiers for the localized message and category text of the event entry and the specified event log entry type.</para>
</summary>
<param name="instanceId">
<attribution license="cc4" from="Microsoft" modified="false" />A resource identifier that corresponds to a string defined in the message resource file of the event source. </param>
<param name="categoryId">
<attribution license="cc4" from="Microsoft" modified="false" />A resource identifier that corresponds to a string defined in the category resource file of the event source, or zero to specify no category for the event. </param>
<param name="entryType">
<attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Diagnostics.EventLogEntryType" /> value that indicates the event type. </param>
</Docs>
</Member>
<Member MemberName="CategoryId">
<MemberSignature Language="C#" Value="public int CategoryId { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 CategoryId" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Event log categories are application-defined values that help filter events, or provide further information about the event. For example, your application can define separate categories for different components or different operations.</para>
<para>Set the <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> property to specify the category that the Event Viewer displays for the entry. The Event Viewer can display the category as a numeric value, or it can use the <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> as a resource identifier to display a localized category string based on the current language settings.</para>
<para>To display localized category strings in the Event Viewer, you must use an event source configured with a category resource file, and set the <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> to a resource identifier in the category resource file. If the event source does not have a configured category resource file, or the specified <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> does not index a string in the category resource file, and then the Event Viewer displays the numeric category value for that entry.</para>
<para>You must register the source with the corresponding resource file before you write event categories using resource identifiers. Configure the category resource file, along with the number of category strings in the resource file, using the <see cref="T:System.Diagnostics.EventLogInstaller" /> or the <see cref="T:System.Diagnostics.EventSourceCreationData" /> class. When defining category strings in a resource file, the category resource identifiers must be numbered consecutively starting at 1, up to the configured <see cref="P:System.Diagnostics.EventSourceCreationData.CategoryCount" /> property value.</para>
<para>Event categories are optional. If your application does not use categories, do not set the <see cref="P:System.Diagnostics.EventInstance.CategoryId" /> for the event log entry.</para>
<para>For details about defining event messages and building event resource files, see the "Message Compiler" topic in the Platform SDK documentation at <see cref="http://msdn.microsoft.com/">http://msdn.microsoft.com</see>. For details about defining event categories in resource files, see the "Event Categories" topic in the Platform SDK</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the resource identifier that specifies the application-defined category of the event entry.</para>
</summary>
</Docs>
</Member>
<Member MemberName="EntryType">
<MemberSignature Language="C#" Value="public System.Diagnostics.EventLogEntryType EntryType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Diagnostics.EventLogEntryType EntryType" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Each event is of a single type, which the application indicates when it reports the event. The Event Viewer uses the event type to determine which icon to display in the list view of the event log.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the event type of the event log entry.</para>
</summary>
</Docs>
</Member>
<Member MemberName="InstanceId">
<MemberSignature Language="C#" Value="public long InstanceId { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance int64 InstanceId" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int64</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.Diagnostics.EventInstance.InstanceId" /> property uniquely identifies an event entry for a configured event source. For events defined in message resource files, the <see cref="P:System.Diagnostics.EventInstance.InstanceId" /> corresponds to the resource identifier compiled from the message definition fields in the message text file. Your application can write localized event log entries by setting the <see cref="P:System.Diagnostics.EventInstance.InstanceId" /> to a resource identifier. The Event Viewer uses the <see cref="P:System.Diagnostics.EventInstance.InstanceId" /> resource identifier to find and display the corresponding string from the localized resource file based on current language settings. You must register the source with the corresponding resource file before you write events using resource identifiers.</para>
<para>For details about defining event messages and building event log resource files, see the "Message Compiler" topic in the Platform SDK documentation at <see cref="http://msdn.microsoft.com/">http://msdn.microsoft.com</see>. For details about event log identifiers, see the "Event Identifiers" topic in the Platform SDK.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets or sets the resource identifier that designates the message text of the event entry.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

1
mcs/class/System/Documentation/en/System.Diagnostics/EventLog.xml.REMOVED.git-id Normal file
View File

@@ -0,0 +1 @@
8a07a040af8b175d6f0ced1259e92d754566c1a3

530
mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntry.xml Normal file
View File

File diff suppressed because it is too large Load Diff

221
mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryCollection.xml Normal file
View File

@@ -0,0 +1,221 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EventLogEntryCollection" FullName="System.Diagnostics.EventLogEntryCollection">
<TypeSignature Language="C#" Maintainer="auto" Value="public class EventLogEntryCollection : System.Collections.ICollection" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit EventLogEntryCollection extends System.Object implements class System.Collections.ICollection, class System.Collections.IEnumerable" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Collections.ICollection</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class when reading the entries associated with an <see cref="T:System.Diagnostics.EventLog" /> instance. The <see cref="P:System.Diagnostics.EventLog.Entries" /> property of the <see cref="T:System.Diagnostics.EventLog" /> class is a collection of all the entries in the event log.</para>
<para>Because new entries are appended to the existing list, stepping through the collection enables you to access the entries that were created after you originally created the <see cref="T:System.Diagnostics.EventLogEntryCollection" />. However, after you view the entire list, it is not updated with new entries.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Defines size and enumerators for a collection of <see cref="T:System.Diagnostics.EventLogEntry" /> instances.</para>
</summary>
</Docs>
<Members>
<Member MemberName="CopyTo">
<MemberSignature Language="C#" Value="public void CopyTo (System.Diagnostics.EventLogEntry[] eventLogEntries, int index);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void CopyTo(class System.Diagnostics.EventLogEntry[] eventLogEntries, int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="eventLogEntries" Type="System.Diagnostics.EventLogEntry[]" />
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<param name="eventLogEntries">To be added.</param>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Because new entries are appended to the existing list, stepping through the collection enables you to access the entries that were created after you originally created the <see cref="T:System.Diagnostics.EventLogEntryCollection" />. An array of <see cref="T:System.Diagnostics.EventLogEntry" /> instances is fixed at the time it is instantiated. Therefore, you cannot read new entries by using the array that is returned by the <see cref="M:System.Diagnostics.EventLogEntryCollection.CopyTo(System.Diagnostics.EventLogEntry[],System.Int32)" /> method.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Copies the elements of the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> to an array of <see cref="T:System.Diagnostics.EventLogEntry" /> instances, starting at a particular array index.</para>
</summary>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index in the array at which copying begins. </param>
</Docs>
</Member>
<Member MemberName="Count">
<MemberSignature Language="C#" Value="public int Count { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance int32 Count" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Docs>
<value>To be added: an object of type 'int'</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Diagnostics.EventLogEntryCollection" /> represents a dynamic list of all the entries in a log. Therefore, the <see cref="P:System.Diagnostics.EventLogEntryCollection.Count" /> property can change during the lifetime of the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> instance that you create. It is usually best to work with the <see cref="P:System.Diagnostics.EventLogEntryCollection.Count" /> property directly instead of assigning its value to a variable.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the number of entries in the event log (that is, the number of elements in the <see cref="T:System.Diagnostics.EventLogEntry" /> collection).</para>
</summary>
</Docs>
</Member>
<Member MemberName="GetEnumerator">
<MemberSignature Language="C#" Value="public System.Collections.IEnumerator GetEnumerator ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Collections.IEnumerator GetEnumerator() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.IEnumerator</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The object that is returned by the <see cref="M:System.Diagnostics.EventLogEntryCollection.GetEnumerator" /> method is a wrapper for the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class that implements the <see cref="T:System.Collections.IEnumerator" /> enumerator.</para>
<block subset="none" type="note">
<para>If the collection is changed during the iteration, the iteration is terminated. To avoid this possibility, see the <see cref="P:System.Diagnostics.EventLogEntryCollection.Item(System.Int32)" /> property for an alternative technique for iterating through a collection.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Supports a simple iteration over the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> object.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An object that can be used to iterate over the collection.</para>
</returns>
</Docs>
</Member>
<Member MemberName="Item">
<MemberSignature Language="C#" Value="public virtual System.Diagnostics.EventLogEntry this[int index] { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Diagnostics.EventLogEntry Item(int32)" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntry</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<param name="index">To be added.</param>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="System.Collections.ICollection.CopyTo">
<MemberSignature Language="C#" Value="void ICollection.CopyTo (Array array, int index);" />
<MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance void System.Collections.ICollection.CopyTo(class System.Array array, int32 index) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="array" Type="System.Array" />
<Parameter Name="index" Type="System.Int32" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Use the <see cref="M:System.Diagnostics.EventLogEntryCollection.CopyTo(System.Diagnostics.EventLogEntry[],System.Int32)" /> method of the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class to copy all or part of the collection to an <see cref="T:System.Diagnostics.EventLogEntry" /> array.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Copies the elements of the collection to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</para>
</summary>
<param name="array">
<attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> that is the destination of the elements that are copied from the collection. The <see cref="T:System.Array" /> must have zero-based indexing. </param>
<param name="index">
<attribution license="cc4" from="Microsoft" modified="false" />The zero-based index in <paramref name="array" /> at which copying begins. </param>
</Docs>
</Member>
<Member MemberName="System.Collections.ICollection.IsSynchronized">
<MemberSignature Language="C#" Value="bool System.Collections.ICollection.IsSynchronized { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool System.Collections.ICollection.IsSynchronized" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class, the <see cref="P:System.Diagnostics.EventLogEntryCollection.System#Collections#ICollection#IsSynchronized" /> method always returns false.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that indicates whether access to the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> is synchronized (thread-safe).</para>
</summary>
</Docs>
</Member>
<Member MemberName="System.Collections.ICollection.SyncRoot">
<MemberSignature Language="C#" Value="object System.Collections.ICollection.SyncRoot { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance object System.Collections.ICollection.SyncRoot" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>For the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class, the <see cref="P:System.Diagnostics.EventLogEntryCollection.System#Collections#ICollection#SyncRoot" /> property always returns the current <see cref="T:System.Diagnostics.EventLogEntryCollection" />.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets an object that can be used to synchronize access to the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> object.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

135
mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryType.xml Normal file
View File

@@ -0,0 +1,135 @@
<?xml version="1.0" encoding="utf-8"?>
<Type Name="EventLogEntryType" FullName="System.Diagnostics.EventLogEntryType">
<TypeSignature Language="C#" Maintainer="auto" Value="public enum EventLogEntryType" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi sealed EventLogEntryType extends System.Enum" />
<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>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
</Base>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The type of an event log entry provides additional information for the entry. Applications set the entry type when they write the entry to the event log.</para>
<para>Each event must be of a single type; the event types cannot be combined for an entry. The Event Viewer uses this type to determine which icon to display in the list view of the log.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Specifies the event type of an event log entry.</para>
</summary>
</Docs>
<Members>
<Member MemberName="Error">
<MemberSignature Language="C#" Value="Error" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Diagnostics.EventLogEntryType Error = int32(1)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An error event. This indicates a significant problem the user should know about; usually a loss of functionality or data.</para>
</summary>
</Docs>
</Member>
<Member MemberName="FailureAudit">
<MemberSignature Language="C#" Value="FailureAudit" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Diagnostics.EventLogEntryType FailureAudit = int32(16)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A failure audit event. This indicates a security event that occurs when an audited access attempt fails; for example, a failed attempt to open a file.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Information">
<MemberSignature Language="C#" Value="Information" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Diagnostics.EventLogEntryType Information = int32(4)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An information event. This indicates a significant, successful operation.</para>
</summary>
</Docs>
</Member>
<Member MemberName="SuccessAudit">
<MemberSignature Language="C#" Value="SuccessAudit" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Diagnostics.EventLogEntryType SuccessAudit = int32(8)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A success audit event. This indicates a security event that occurs when an audited access attempt is successful; for example, logging on successfully.</para>
</summary>
</Docs>
</Member>
<Member MemberName="Warning">
<MemberSignature Language="C#" Value="Warning" />
<MemberSignature Language="ILAsm" Value=".field public static literal valuetype System.Diagnostics.EventLogEntryType Warning = int32(2)" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyVersion>1.0.5000.0</AssemblyVersion>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Diagnostics.EventLogEntryType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<remarks>To be added</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A warning event. This indicates a problem that is not immediately significant, but that may signify conditions that could cause future problems.</para>
</summary>
</Docs>
</Member>
</Members>
</Type>

Some files were not shown because too many files have changed in this diff Show More