Как может XML-документация для веб-API включать документацию, выходящую за рамки основного проекта?

Для этого нет встроенного способа. Однако для этого требуется всего несколько шагов:

1. Включите XML-документацию для вашего подпроекта (из свойств / сборки проекта), как для вашего проекта веб-API. За исключением этого раза, направьте его прямо на XmlDocument.xml, чтобы он был сгенерирован в корневой папке вашего проекта.

2. Измените событие postbuild вашего проекта Web API, чтобы скопировать этот XML-файл в вашу App_Data папку:

   copy "$(SolutionDir)SubProject\XmlDocument.xml" "$(ProjectDir)\App_Data\Subproject.xml"
   

   Где Subproject.xml следует переименовать в любое имя вашего проекта плюс .xml.

3. Затем откройте Areas\HelpPage\App_Start\HelpPageConfig и найдите следующую строку:

   config.SetDocumentationProvider(new XmlDocumentationProvider(
       HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));
   

   Это строка, которую вы изначально раскомментировали, чтобы в первую очередь включить справочную XML-документацию. Замените эту строку на:

   config.SetDocumentationProvider(new XmlDocumentationProvider(
       HttpContext.Current.Server.MapPath("~/App_Data")));
   

   Этот шаг гарантирует, что XmlDocumentationProvider будет передан каталог, содержащий ваши файлы XML, а не конкретный файл XML для вашего проекта.

4. Наконец, измените Areas\HelpPage\XmlDocumentationProvider следующими способами:

   а. Замените поле _documentNavigator на:

   private List<XPathNavigator> _documentNavigators = new List<XPathNavigator>();
   

   б. Замените конструктор на:

   public XmlDocumentationProvider(string appDataPath)
   {
       if (appDataPath == null)
       {
           throw new ArgumentNullException("appDataPath");
       }
   
       var files = new[] { "XmlDocument.xml", "Subproject.xml" };
       foreach (var file in files)
       {
           XPathDocument xpath = new XPathDocument(Path.Combine(appDataPath, file));
           _documentNavigators.Add(xpath.CreateNavigator());
       }
   }
   

   c. Добавьте следующий метод под конструктором:

   private XPathNavigator SelectSingleNode(string selectExpression)
   {
       foreach (var navigator in _documentNavigators)
       {
           var propertyNode = navigator.SelectSingleNode(selectExpression);
           if (propertyNode != null)
               return propertyNode;
       }
       return null;
   }
   

   d. И, наконец, исправьте все ошибки компилятора (их должно быть три), приводящие к ссылкам на _documentNavigator.SelectSingleNode, и удалите часть _documentNavigator., чтобы теперь она вызывала новый метод SelectSingleNode, который мы определили выше.

Этот последний шаг - это то, что изменяет поставщика документов для поддержки поиска текста справки в нескольких XML-документах, а не только в основном проекте.

Теперь, когда вы изучите свою справочную документацию, она будет включать XML-документацию по типам из вашего связанного проекта.

Я тоже столкнулся с этим, но я не хотел редактировать или дублировать какой-либо сгенерированный код, чтобы избежать проблем позже.

Основываясь на других ответах, вот автономный поставщик документации для нескольких источников XML. Просто вставьте это в свой проект:

/// <summary>A custom <see cref="IDocumentationProvider"/> that reads the API documentation from a collection of XML documentation files.</summary>
public class MultiXmlDocumentationProvider : IDocumentationProvider, IModelDocumentationProvider
{
    /*********
    ** Properties
    *********/
    /// <summary>The internal documentation providers for specific files.</summary>
    private readonly XmlDocumentationProvider[] Providers;


    /*********
    ** Public methods
    *********/
    /// <summary>Construct an instance.</summary>
    /// <param name="paths">The physical paths to the XML documents.</param>
    public MultiXmlDocumentationProvider(params string[] paths)
    {
        this.Providers = paths.Select(p => new XmlDocumentationProvider(p)).ToArray();
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetDocumentation(MemberInfo subject)
    {
        return this.GetFirstMatch(p => p.GetDocumentation(subject));
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetDocumentation(Type subject)
    {
        return this.GetFirstMatch(p => p.GetDocumentation(subject));
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetDocumentation(HttpControllerDescriptor subject)
    {
        return this.GetFirstMatch(p => p.GetDocumentation(subject));
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetDocumentation(HttpActionDescriptor subject)
    {
        return this.GetFirstMatch(p => p.GetDocumentation(subject));
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetDocumentation(HttpParameterDescriptor subject)
    {
        return this.GetFirstMatch(p => p.GetDocumentation(subject));
    }

    /// <summary>Gets the documentation for a subject.</summary>
    /// <param name="subject">The subject to document.</param>
    public string GetResponseDocumentation(HttpActionDescriptor subject)
    {
        return this.GetFirstMatch(p => p.GetResponseDocumentation(subject));
    }


    /*********
    ** Private methods
    *********/
    /// <summary>Get the first valid result from the collection of XML documentation providers.</summary>
    /// <param name="expr">The method to invoke.</param>
    private string GetFirstMatch(Func<XmlDocumentationProvider, string> expr)
    {
        return this.Providers
            .Select(expr)
            .FirstOrDefault(p => !String.IsNullOrWhiteSpace(p));
    }
}

... и включите его в своем HelpPageConfig указав пути к нужным XML-документам:

config.SetDocumentationProvider(new MultiXmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/Api.xml"), HttpContext.Current.Server.MapPath("~/App_Data/Api.Models.xml")));

Еще один упрощенный способ сделать это - объединить файлы xml. Пример кода в моем ответе ниже:

XML-комментарии страницы справки веб-API из более чем 1 файла

Самый простой способ решить эту проблему - создать папку App_Code на развернутом сервере. Затем скопируйте файл XmlDocument.xml, который находится в папке bin, локально в папку App_Code.

Я нашел лучшее решение

1. Перейдите к свойствам вашего решения и на странице Built, Out Put, Documentation XML File просто заполните свою папку данными вашего приложения.

2. Добавьте строку с файлом, который вы хотите вставить в свою документацию, вот так.

config.SetDocumentationProvider (новый XmlDocumentationProvider (HttpContext.Current.Server.MapPath (~ / App_Data / FenixCorporate.API.xml)));

        config.SetDocumentationProvider(new XmlDocumentationProvider(
            HttpContext.Current.Server.MapPath("~/App_Data/FenixCorporate.Entities.xml")));