C# 可空二维数组的XML注释

C# 可空二维数组的XML注释,c#,multidimensional-array,nullable,xml-comments,C#,Multidimensional Array,Nullable,Xml Comments,如何正确地为可空双精度的2D数组指定XML注释?下面给出了语法错误 /// <returns>The <see cref="double[,]"/>.</returns> public double?[,] Get2DArray() { ... } ///这个。 公共双精度?[,]Get2DArray() { ... } 如果它只是一个二维数组,我会使用: /// <returns>The <see cref="double{T,

如何正确地为可空双精度的2D数组指定XML注释?下面给出了语法错误

/// <returns>The <see cref="double[,]"/>.</returns>
public double?[,] Get2DArray()
{
    ...
}
///这个。
公共双精度?[,]Get2DArray()
{
...
}
如果它只是一个二维数组,我会使用:

/// <returns>The <see cref="double{T,T}]"/>.</returns>
public double[,] Get2DArray()
{
    ...
}
///这个。
公共双精度[,]Get2DArray()
{
...
}
如果只是一个值,我会使用:

/// <returns>The <see cref="Nullable{Double}"/>.</returns>
public static double? GetNullableDouble()
{
///这个。
公共静态双?GetNullableDouble()
{
我似乎无法将这两个概念结合起来得到正确的评论。

阅读后,也许你想

/// <summary>
/// Gets the 2D Array
/// </summary>
/// <returns>The <see cref="T:double?[,]"/>.</returns>
public double?[,] Get2DArray()
{
    ...
}

就足够了。

问题是没有泛型数组类型,因此没有可引用的内容。我相信这是使用编译器魔法完成的,但这超出了我的知识范围

我查看了一堆核心.NET源代码,看看关于数组的
cref
值是否使用了任何通用引用,但我什么也没找到。所有这些都使用

我建议您最好使用以下格式:

<returns>The 2-dimentional <see cref="System.Array"/> of <see cref="System.Nullable{System.Double}" />.</returns>

多维数组不是泛型数组,所以我不理解你的问题。更一般地说,使用锯齿数组(
双精度?[]]]
),锯齿数组的.net实现在多个方面都有优势。“XML注释…给我语法错误”XML注释给出语法错误!我不明白。当我将鼠标悬停在文本上时[,]工具提示显示“语法错误”。当我将鼠标悬停在函数标题中的T:double?[,]上时,工具提示显示“无法解析符号‘T:double?[,]”。但是,从调用代码来看,签名似乎是正确的。
<returns>The 2-dimentional <see cref="System.Array"/> of <see cref="System.Nullable{System.Double}" />.</returns>