在哪里放置附加属性的XML文档注释?

时间:2009-08-03 20:27:19

标签: c# wpf xml-documentation attached-properties

假设我有一个如下定义的附加属性:

    public static string GetMyProperty(DependencyObject obj)
    {
        return (string)obj.GetValue(MyPropertyProperty);
    }

    public static void SetMyProperty(DependencyObject obj, string value)
    {
        obj.SetValue(MyPropertyProperty, value);
    }

    // Using a DependencyProperty as the backing store for MyProperty.  This enables animation, styling, binding, etc...
    public static readonly DependencyProperty MyPropertyProperty =
        DependencyProperty.RegisterAttached("MyProperty", typeof(string), typeof(MyClass), new UIPropertyMetadata(0));

我可以编写属性标识符(MyPropertyProperty)和访问者(GetMyPropertySetMyProperty)的文档,但我不知道在哪里放置 MyClass.MyProperty附加属性,因为它不是实际的代码元素。

MSDN库包含此类文档(例如参见Grid.Row),因此必须可以...

我应该在哪里放置附加属性的XML文档注释?

2 个答案:

答案 0 :(得分:6)

Sandcastle有一个article

答案 1 :(得分:1)

即使答案有点晚,我也在Visual Studio运行期间找到了文档外观的解决方案。

如果您使用ReSharper并按 CTRL Q ,则使用SetXXX - 方法上方添加的XML文档来显示{{ 1}}。