C#では、<see cref = "blah" />を使用して、paramsキーワードを含むメソッドシグネチャを参照しようとしています。これがパラメータリストを配列に変換することは知っていますが、CREF属性で配列を参照する方法さえ理解できません。私は自分の検索で何も見つけていませんし、私が知っている人も誰も考えを持っていません。コンパイラは角かっこで窒息しています。中括弧を使用し、Arrayクラスを使用して、あらゆる種類の異なる組み合わせを試しましたが、何も機能していません。誰かがこれを知っていますか?
3 に答える
B.3.1 ID 文字列形式の記事によると、配列の参照は [角かっこ] (オプションのlowerbound:size
指定子を使用) で行われますが、特定の型の配列 (またはオブジェクト配列) を参照するだけの場合は、次のことができます。書くだけじゃない
<see cref="Object[]"/>
T:
代わりに、プレフィックスを使用して型参照を作成していることを指定する必要があります。
<see cref="T:Object[]"/>
これは、次のようなメソッドの特定のオーバーロードを参照する場合には当てはまらないようです。
<seealso cref="String.Join(String, String[])"/>
ECMA 334標準PDF、付録Eには、XMLドキュメントのコメントの適切な概要が含まれています。標準は次の場所からダウンロードできます。
http://www.ecma-international.org/publications/standards/Ecma-334.htm
具体的には、496ページから始まるセクションE.3.1が必要になります。
同様のコンテンツがMSDNにもあります(MSDNにはこのトピックに関するひどいナビゲーションがあるようですが、他のセクションを見つけるのは困難です)。
http://msdn.microsoft.com/en-us/library/aa664787(VS.71).aspx
E.3.1と同等:
http://msdn.microsoft.com/en-us/library/aa664807(VS.71).aspx
また、Monoのドキュメントが役立つ場合があります。
http://www.go-mono.com/docs/index.aspx?tlink=29@man%3amdoc(5)
具体的には、「CREFFORMAT」セクションでID文字列の規則について説明します。
更新2018/05/23
上記のECMA-334標準PDFのURLは、標準の最新版にリンクしています。2009年には、それが規格の第4版でした。ただし、2017年12月現在、第5版が最新であり、第4版のセクションE.3.1が第5版のセクションD.4.2になりました。
ECMA-334標準の以前のバージョンは、次のページからダウンロードできます。https ://www.ecma-international.org/publications/standards/Ecma-334-arch.htm
param キーワードを省略して、次のように型を挿入するだけです。
/// <summary>
/// <see cref="Method(string[])"/>
/// </summary>
public static void Main()
{
Method("String1", "String2");
}
public static void Method(params string[] values)
{
foreach (string value in values)
{
Console.WriteLine(value);
}
}