Como podem os comentários XML código fonte .NET ser persistentes nos metadados do assembly?

Question

Você já reparou que, para alguns métodos nas assembléias do sistema, o .NET Reflector também mostra a respectiva documentação? O que significa que a documentação pode ser persistentes nos metadados do assembly.

Como posso fazê-lo funcionar para minhas próprias assembléias? Ou seja, eu quero ver meus comentários para o meu método quando eu refleti-la no .NET Reflector.

Graças.

Answer 1

comentários doc XML não são persistentes nos metadados do assembly. Na verdade, Visual Studio e outras ferramentas como refletor localizar comentários documento XML através de pesquisa através de um conjunto de caminhos bem conhecidos que contenham comentário XML doc arquivos.

Se você quiser ver a documentação do XML para suas próprias montagens, verifique se o arquivo XML está no mesmo diretório do assembly que está sendo referenciado, e compartilha o mesmo nome de seu conjunto (menos a extensão). Por exemplo, corresponde ao MyAssembly.Namespace.XML MyAssembly.Namespace.dll montagem.

Consulte Como ver comentários XML do código do refletor para mais informações.