<exception> (Visual C++)
Тег <exception> служит для указания возможных исключений.Этот тег применяется к определению метода.
<exception cref="member">description</exception>
Параметры
member
Ссылка на исключение, которое доступно из текущей среды компиляции.С помощью правил поиска имени, компилятор проверяет, что данное исключение существует, и преобразует member в каноническое имя элемента в выходных XML-данных.Компилятор выдает предупреждение, если не удается найти member.Заключить его в одинарные или двойные кавычки.
Дополнительные сведения о создании cref-ссылки на универсальный тип см. в разделе <see> (Visual C++).
description
Описание
Заметки
Чтобы обработать и сохранить комментарии документации в файл, при компиляции необходимо использовать параметр /doc.
Компилятор C Visual C++ пытается разрешить ссылки cref в одном прохождении через документирующие комментарии.Поэтому при использовании правила поиска C, C++, символ не найден компилятором, ссылка будет помечена как не разрешен.Дополнительные сведения см. в разделе <seealso> (Visual C++).
Пример
// xml_exception_tag.cpp
// compile with: /clr /doc /LD
// post-build command: xdcmake xml_exception_tag.dll
using namespace System;
/// Text for class EClass.
public ref class EClass : public Exception {
// class definition ...
};
/// <exception cref="System.Exception">Thrown when... .</exception>
public ref class TestClass {
void Test() {
try {
}
catch(EClass^) {
}
}
};