如何在方法或屬性中記錄返回類型爲通用Action或Func的類型參數

Question

我有一個非常簡單的問題，您將如何用xmldoc記錄一個方法或具有通用Action或Func返回類型的屬性。 例如：

/// <summary> 
/// Gets or sets the print method. Parameters: file, printer name??? 
/// </summary> 
/// <value> 
/// The print method. 
/// </value> 
public Action<string, string> PrintMethod { get; set; } 

這是哪種情況下的最佳做法？

Answer 1

如果您需要記錄此操作的參數，請不要使用Action<string, string>：改爲創建自定義委託，並記錄委託的參數。

/// <summary> 
/// Gets or sets the print method. 
/// </summary> 
/// <value> 
/// The print method. 
/// </value> 
public FilePrintAction PrintMethod { get; set; } 

/// <summary> 
/// Represents a method for printing a file to a printer 
/// </summary> 
/// <parameter name="file">Path of the file to print</parameter> 
/// <parameter name="printerName">Name of the printer</parameter> 
public delegate void FilePrintAction(string file, string printerName);