我使用Microsoft Visual Studio 2012.当我将代码示例放入C#classes/methods的XML注释中时,我想知道:引用我的程序集的用户将如何看到该代码示例?
我试图引用自己的程序集,我找到的唯一方法是:查看assembly.xml文件.我可以解决Visual Studio或其他任何东西来查看这些代码示例吗?
以下是我对评论的评价:
/// <summary>
/// This is my method example
/// </summary>
/// <example>
/// <code>
/// // Here is my code example. Call my method like this:
/// const int a = 10;
/// MethodExample(a);
/// </code>
/// </example>
public static void MethodExample(int parameter)
{
}
Run Code Online (Sandbox Code Playgroud)
这是我在intellisense中得到的:

这是我在对象浏览器中得到的:

这是我在assembly.xml文件中得到的:

我想得到的内容:请参阅对象浏览器和智能感知中的代码示例.
我使用了样本F#Empty WPF项目,并通过Nuget引入了Paul Bett的ReactiveUI项目.通常当我按下(shift-f2)C#/ VB.Net中的标识符时,它会将我带到对象浏览器,以便我可以探索对象的界面.但是有两个问题.
最初,对象浏览器中甚至不提供ReactiveUI.我不得不去每个引用的对象浏览器中点击浏览器和明确点击视图,然后它们出现在对象浏览器中.Perhapps这是用于F#项目?
第二,当我在我的F#代码中有一个符号时,说一个ReactiveObject的实例和do(shift-f2)我得到一个错误无法导航到定义.源代码不可用.
所以我的问题是如何解决上述两个问题,第二个问题是最重要的问题.
在我对方法和类的.NET XML注释中,我尝试在<example><code></code></example>块中提供用法示例.当我使用Sandcastle使用我的XML文档生成.chm文档文件时,它总是很好地格式化并尊重我的<code>块中的换行符.但是,当我在Visual Studio的对象浏览器中浏览类和方法时,所有内容都在一行中运行,并且字体完全相同(代码不是等宽字体).这是由于我在XML评论中没有做到的事情,还是对象浏览器只是愚蠢的?我专门使用Visual Studio 2008 Team System.
我想在类级别(在这种情况下实际上是a Module)提供更高级别的详细信息,包括代码示例等,但是我无法使用各种标签.
''' <summary>
''' Here's a summary of <c>SmallCodeChunk</c>
''' </summary>
''' <example>
''' Mmm, Skynet?
''' <code>
''' code.CodingItself("that's so meta!")
''' </code>
''' </example>
''' <remarks>
''' <para>Unit testable by replacing the <see cref="Implementation"/> property
''' with a mocked/stubbed <see cref="IThingy"/>.
''' </para>
''' <para>Paragraph of a bunch of stuff. <c>Y</c> is used for <c>True</c> just
''' for the sake of making the universe a (not) better place.
''' </para>
''' </remarks>
Run Code Online (Sandbox Code Playgroud)
我意识到使用的某些标签(例如<exception>)可能并不真正有效,但似乎我应该可以做类似的事情<example> …
Microsoft Docs 未列出 Object 的所有属性Application.ActiveSheet:https :
//docs.microsoft.com/en-us/office/vba/api/excel.application.activesheet
它只包含了一些属性,例如:ActiveSheet.Name。但是从我在互联网上找到的 VBA 脚本中,我知道还有更多的属性,例如:ActiveSheet.Type
所以我想也许我可以用这个 VBA 代码列出它们:来自:VBA 集合:键列表
Sub AktivSheet()
Dim key As Variant
For Each key In Application.ActiveSheet
Debug.Print "Key: " & key, "Value: " & Application.ActiveSheet.Item(key)
Next
End Sub
Run Code Online (Sandbox Code Playgroud)
但它不起作用,Microsoft Docs 建议使用对象浏览器。但是对象浏览器没有列出 Application.ActiveSheet 的属性:
我没主意了!我只想要所有 ActiveSheet 属性的列表。因为我只需要知道活动工作表的文本方向,就好像它是从左到右或从右到左一样。
我试图与我的鼠标离婚,以便成为更多的产品,为了做到这一点,我必须找到常用操作的关键组合.
每次我在VS中启动对象浏览器时,重点都放在命名空间和类的树上.
如何将此焦点移至搜索框?
更好的是:如何启动专注于搜索框的对象浏览器,以便输入我的搜索条件?
.net ×2
c# ×1
excel ×1
f# ×1
formatting ×1
intellisense ×1
object ×1
search ×1
vb.net ×1
vba ×1
xml-comments ×1