Что XML файл, который поставляется вместе с файлом сборки .NET?
Многие сборки .NET сопровождаются XML файлом. Например, System.Web.WebPages.Razor.dll
объединяется с System.Web.WebPages.Razor.xml
, который содержит следующее:
<?xml version="1.0" encoding="utf-8" ?>
<doc>
<assembly>
<name>System.Web.WebPages.Razor</name>
</assembly>
<members>
<member name="T:System.Web.WebPages.Razor.PreApplicationStartCode" />
<member name="M:System.Web.WebPages.Razor.PreApplicationStartCode.Start" />
<member name="T:System.Web.WebPages.Razor.RazorBuildProvider" />
<member name="M:System.Web.WebPages.Razor.RazorBuildProvider.#ctor" />
Much more elements follow...
</members>
</doc>
Для чего нужен этот XML? Нужно ли мне это во время выполнения?
Ответы
Ответ 1
Это файл кодов комментариев /intellisense и используется средой IDE (например, Visual Studio), а не средой выполнения - здесь появляются все расширенные описания методов/параметров/типов и т.д.
Вам не нужно разворачивать его с помощью своего двоичного файла, но это тоже не повредит. Это также полностью необязательно в IDE - просто: intellisense будет менее информативным для вас без него (он будет просто отображать имена и типы te и т.д. - не более подробные описания методов).
В вашей собственной библиотеке используйте синтаксис///для написания собственных комментариев кода и включите создание файла XML в свойствах проекта.
Ответ 2
Это XML-документация для этой сборки. Это используется только для Intellisense в VisualStudio. Подробнее см. этот ответ.