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
相关产品推荐
相关产品推荐

