Что 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. Подробнее см. этот ответ.