分享方式:


<exception> 檔標籤

<exception> 標記可讓您指定可以擲回的例外狀況。 此標記會套用到方法定義。

語法

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

參數

member
目前編譯環境中可用的例外狀況參考。 使用名稱查閱規則,編譯器會檢查指定的例外狀況是否存在,並將 member 轉譯為輸出 XML 中的標準項目名稱。 如果 member找不到 ,則編譯程式會發出警告。

以單引號或雙引號將名稱括起來。

如需如何建立 cref 泛型型別參考的詳細資訊,請參閱 <see>

description
描述。

備註

使用 /doc 編譯 以處理檔案的檔批注。

MSVC 編譯程式會嘗試在一次傳遞檔批注中解析 cref 參考。 如果使用C++查閱規則,當編譯程式找不到符號時,參考會標示為無法解析。 如需詳細資訊,請參閱<seealso>

範例

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

另請參閱

XML 檔