You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VS2022中带XML注释的自定义方法IntelliSense注释不显示

Visual Studio 2022 Web项目中<inheritdoc>继承的XML注释无法在IntelliSense中显示

复现代码

首先是编写了完整XML注释的ITransaction接口:

namespace NamespaceName.Core.Services
{
    public interface ITransaction : IDisposable
    {
        /// <summary>
        /// 向指定队列发送消息,可选择按传入的计划时间延迟发送
        /// </summary>
        /// <param name="queueName">消息发送的目标队列名称</param>
        /// <param name="message">待发送的消息内容</param>
        /// <param name="messageId">待发送的消息ID</param>
        /// <param name="enqueueDateTime">消息入队的可选时间参数,必须使用UTC时间</param>
        Task SendMessageAsync(string queueName, object message, string? messageId = null, DateTime? enqueueDateTime = null);
    }
}

在MessageService类中定义实现该接口的私有密封类Transaction,类中SendMessageAsync方法通过<inheritdoc>标签直接继承接口对应方法的XML注释:

namespace NamespaceName.Core.Services
{
  public class MessageService : IMessageService, IDisposable, IAsyncDisposable
  {
    private sealed class Transaction : ITransaction
    {
      /// <inheritdoc cref="ITransaction.SendMessageAsync(string, object, string?, DateTime?)"/>
      public async Task SendMessageAsync(string queueName, object message, 
      string? messageId = null, DateTime? enqueueDateTime = null) {...}
    }
  } 
}

异常表现

调用上述SendMessageAsync方法时,IntelliSense未正常展示继承得到的XML注释内容,仅提示 Intellicode suggestion based on the current context。

环境信息与已尝试操作

  • 开发环境:Visual Studio 2022
  • 已尝试重启Visual Studio,问题未得到解决
  • 同一解决方案下的控制台应用项目中,XML注释的IntelliSense展示功能完全正常,仅当前Web应用项目存在该异常

求助问题

需要修改什么配置、执行什么操作才能修复该异常?


内容的提问来源于stack exchange,提问作者imsan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.26 16:27:40