c# - c＃コメントにxamlコードを追加する方法は？

Question

/// <summary>
/// 
/// </summary>
/// <remarks
/// 
/// </remarks>

上記のコメントにxamlコードを追加し、コードパーサーが存在しないリンクを作成しないようにする方法（CTRL +クリックメッセージ）？

Answer 1

XAML ビューで、使用する XAML をコメントとして入力します。

次に、それを囲みます

<!-- #region XAML Snippet -->
<StackPanel>
  <Button Content="Click me, I do nothing!" />
</StackPanel>
<!-- #endregion -->

注: これを MainWindow.xaml ファイルに入れましたが、任意の XAML ファイルにすることができます。

C# でこれをコメントとして使用するには、次のようにします。

/// <summary>
/// Interaction logic for MainWindow.xaml
/// </summary>
/// <example>
/// <code source="MyProject.Namespace/MainWindow.xaml" region="XAML snippet" lang="XAML" title="A linked *.xaml file treated as XAML"/>
/// </example>

SandCastle はこの構文を理解し、(MSDN のように) 適切なドキュメントを生成しますが、これは intellisense では表示されません。

XAML 構文を模倣するために、記号の代わりにand を使用して通常<summary>の本文をフォーマットすることもできますが、それは面倒です。&gt;&lt;< >

Answer 2

次の 2 つのオプションがあります。

1. 標準の XML エスケープ

   /// <TextBlock Text="Hello World!"/>

2. CDATA セクション

   /// <![CDATA[<TextBlock Text="Hello World!"/>]]>

最初のオプションを使用すると、Visual Studio Intellisense はエスケープされていない XML シーケンスを適切に表示します。

Answer 3

CDATA タグを使用しますか?

/// <summary>
/// <![CDATA[<StackPanel />]]>
/// </summary>

注: これは Intellisense には表示されないため、それが要件である場合、この方法はシナリオでは機能しません。

しかし、なぜ XAML をコード ファイルに追加する必要があるのでしょうか。