Partilhar via


<exception> (Visual C++)

A marca de <exception> permite que você especifique que exceções podem ser geradas.Essa marca é aplicada a uma definição de método.

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

Parâmetros

  • member
    Uma referência a uma exceção que está disponível no ambiente de compilação atual.Usando regras de pesquisa de nome, o compilador verifica se a exceção determinada existir, e converte member para o nome canônico de elemento na saída XML.O compilador emite um aviso se não encontrar member.

    Envolva-o com aspas simples ou double - marcas.

    Para obter informações sobre como criar uma referência de cref a um tipo genérico, consulte <see> (Visual C++).

  • description
    Uma descrição.

Comentários

Compile com /doc para processar comentários de documentação para um arquivo.

O compilador do Visual C++ tentará resolver referências de cref em uma passagem com comentários de documentação.Portanto, se usando as regras de pesquisa de C++, um símbolo não for encontrado pelo compilador a referência não será marcada como resolvida.Consulte <seealso> (Visual C++) para maiores informações.

Exemplo

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

Consulte também

Outros recursos

XML Documentation (Visual C++)