C# 部分继承包含的xml注释<;继承doc/>;

C# 部分继承包含的xml注释<;继承doc/>;,c#,vb.net,visual-studio,inheritance,comments,C#,Vb.net,Visual Studio,Inheritance,Comments,我刚刚发现它现在默认包含在VisualStudio中。因此,我开始为我的类编写注释,该类广泛使用继承。我试图做的是从上面继承我的部分描述。因此,例如,当为继承类的构造函数编写xml注释时,我希望他继承参数的描述,但希望为摘要字段指定更具体的注释。我尝试过这种方法,但不幸的是,它不起作用: ''' <summary> ''' Creates a new belt-instance ''' </summary> ''' <param name="Opc

我刚刚发现它现在默认包含在VisualStudio中。因此,我开始为我的类编写注释,该类广泛使用继承。我试图做的是从上面继承我的部分描述。因此,例如,当为继承类的构造函数编写xml注释时,我希望他继承参数的描述,但希望为摘要字段指定更具体的注释。我尝试过这种方法,但不幸的是,它不起作用:

    ''' <summary>
''' Creates a new belt-instance
''' </summary>
''' <param name="OpcClient"><inheritdoc/></param>
''' <param name="BaseNode"><inheritdoc/></param>
''' <param name="PropertyChangedNotificationsRequested"><inheritdoc/>/param>
Sub New(ByRef OpcClient As OpcUaClient, ByVal BaseNode As OpcNodeId, ByVal PropertyChangedNotificationsRequested As Boolean)
    MyBase.New(OpcClient, BaseNode, PropertyChangedNotificationsRequested)
    ...
End Sub
“”
''创建一个新皮带实例
''' 
''' 
''' 
''/param>
Sub-New(ByRef OpcClient作为OpcUaClient,ByVal BaseNode作为OpcNodeId,ByVal PropertyChangedNotificationsRequested作为Boolean)
MyBase.New(OpcClient、BaseNode、PropertyChangedNotificationsRequested)
...
端接头

总是继承整个评论似乎有点过头了,因为你越是深入继承链,大多数时候评论就越是笼统和不具体如何实现评论的部分继承?

我在互联网上没有找到解决方案,但尝试了一些不同的解决方案。下面的方法似乎有效

  • 添加所有要覆盖的内容
  • 添加后面的内容
  • 例如:

        ''' <summary>
    ''' I am overriding
    ''' </summary>
    ''' <param name="BaseNode">I am also</param>
    ''' <inheritdoc/>
    Sub New(ByRef OpcClient As OpcUaClient, ByVal BaseNode As OpcNodeId, ByVal PropertyChangedNotificationsRequested As Boolean)
        MyBase.New(OpcClient, BaseNode, PropertyChangedNotificationsRequested)
        ...
    End Sub
    
    “”
    ''我压倒一切
    ''' 
    “我也是
    ''' 
    Sub-New(ByRef OpcClient作为OpcUaClient,ByVal BaseNode作为OpcNodeId,ByVal PropertyChangedNotificationsRequested作为Boolean)
    MyBase.New(OpcClient、BaseNode、PropertyChangedNotificationsRequested)
    ...
    端接头
    
    如果还有一个更干净的解决方案或一些关于这个案例的附加信息,我想听听