2

关于 XML 文档的 MSDN 页面显示您可以编写简单的内容，例如：

/// <summary>Builds a new string whose characters are the results of applying the function <c>mapping</c>
/// to each of the characters of the input string and concatenating the resulting
/// strings.</summary>
/// <param name="mapping">The function to produce a string from each character of the input string.</param>
///<param name="str">The input string.</param>
///<returns>The concatenated string.</returns>
///<exception cref="System.ArgumentNullException">Thrown when the input string is null.</exception>
val collect : (char -> string) -> string -> string

但是您可以在 XML 文档中嵌入图像吗？

4

1 回答 1

3

您可以<img ... />在 XML 文档中包含和其他 HTML 标记。我刚刚尝试过，Visual Studio 只是跳过了图像（因此您不会在 IntelliSense 中看到它），但fshtmldocF# Power Pack 中的工具只是将 HTML 标记复制到包含图像的输出 HTML 文档中。

/// <summary>Hi <img src="http://tomasp.net/img/fpman.jpg" /> there!</summary>
type IMultiKey = 
  // (...)

给我以下生成的文档：

在此处输入图像描述

我认为 C# 编译器对 XML 标记做了一些额外的验证，但我不认为这是在 F# 编译器中完成的。顺便说一句，我发现编写 XML 文档的时间很长，所以我正在尝试使用F# Formatting来用 Markdown 编写它们（但我还没有准备好任何东西）。

于 2013-09-23T19:23:32.660 回答