Share via

<exception> (C#-Programmierhandbuch)

  • Artikel

Aktualisiert: November 2007

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

Parameter

  • cref = "member"
    ein Verweis auf eine Ausnahme, die in der aktuellen Kompilierungsumgebung verfügbar ist. Der Compiler überprüft, ob die angegebene Ausnahme vorhanden ist, und übersetzt member in den tatsächlichen Elementnamen in der ausgegebenen XML. member muss in doppelte Anführungszeichen (" ") eingeschlossen werden.

    Weitere Informationen zum Erstellen von cref-Verweisen auf einen generischen Typ finden Sie unter <see> (C#-Programmierhandbuch).

  • description
    Eine Beschreibung der Ausnahme.

Hinweise

Mit dem <exception>-Tag können Sie festlegen, welche Ausnahmen ausgelöst werden können. Dieses Tag kann für Definitionen für Methoden, Eigenschaften, Ereignisse und Indexer übernommen werden.

Dokumentationskommentare werden zu einer Datei verarbeitet, indem sie mit "/doc" kompiliert werden.

Beispiel

// 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)
        {
        }
    }
}

Siehe auch

Konzepte

C#-Programmierhandbuch

Referenz

Empfohlene Tags für Dokumentationskommentare (C#-Programmierhandbuch)