c# - 您如何为委托(delegate)参数提供 xml 注释/文档？

Question

给了一个委托(delegate)

Func<string,string,string> MyFunc = (firstName,lastName) => string.Format("Given Name:{0} Surname:{1}",
                                                                            firstName,
                                                                            lastName);

如何记录 firstName 和 lastName 的参数，以便它们显示在智能感知中(就像方法描述和参数一样)？
示例:

/// <summary>
/// My Method
/// </summary>
/// <param name="firstName">The first name.</param>
/// <param name="lastName">The last name.</param>
/// <returns></returns> 
public string MyMethod(string firstName, string lastName)
{ 
  return string.Format("Given Name:{0} Surname:{1}",firstName,lastName);
}

我想将鼠标悬停在委托(delegate)上，或者在我键入并告诉我委托(delegate)参数的描述时让智能感知弹出窗口，就像使用上述方法一样。

Answer 1

委托(delegate)类型的字段仍然是字段而不是方法——它本身不接受参数。参数属于委托(delegate)类型，而不属于委托(delegate)字段。如果需要，您可以在委托(delegate)类型时为参数编写注释。

/// <summary>
/// Tests something.
/// </summary>
/// <param name="test">Something that's going to be tested.</param>
delegate void Test(int test);

Func<string,string,string>是具有三个参数的函数的一般委托(delegate)。出于特定目的，您始终可以更具体地声明委托(delegate)抽象方法的自己的委托(delegate)类型，并为其参数添加注释。