Home Library Learn Samples Downloads Support Community Forums
2 out of 3 rated this helpful - Rate this topic

<exception> (C# Programming Guide)

Visual Studio 2012

Copy 
<exception cref="member">description</exception>
cref = " member"

A reference to an exception that is available from the current compilation environment. The compiler checks that the given exception exists and translates member to the canonical element name in the output XML. member must appear within double quotation marks (" ").

For more information on how to create a cref reference to a generic type, see <see> (C# Programming Guide).

description

A description of the exception.

The <exception> tag lets you specify which exceptions can be thrown. This tag can be applied to definitions for methods, properties, events, and indexers.

Compile with /doc to process documentation comments to a file.

For more information about exception handling, see Exceptions and Exception Handling (C# Programming Guide).

C#
Copy 
// compile with: /doc:DocFileName.xml  

/// Comment for class 
public class EClass : System.Exception
{
    // class definition...
}

/// Comment for class 
class TestClass
{
    /// <exception cref="System.Exception">Thrown when...</exception>
    public void DoSomething()
    {
        try
        {
        }
        catch (EClass)
        {
        }
    }
}
Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.