このトピックは、構文ツリーにデータを追加、取得する方法について説明します。
本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。
構文ツリーから情報を取得するには、ツリー上にも情報を保存します。ツリー内の SyntaxTree およびすべてのオブジェクトは不変であり、そのため追加情報を保存する唯一の方法は、含まれる追加データのあるツリーのコピーを作成することです。これは、診断情報 (セマンティック エラーまたは警告など) または注釈のために実施します。どの種類のデータでもかまいません。このデータをツリーにアタッチできるメソッドは、SyntaxTree 上で定義されます。
注:
注釈をアタッチするには、SyntaxTree の AddAnnotation メソッドを使用して、アタッチする SyntaxAnnotation を提供します。SyntaxAnnotation クラスは、いずれかのデータをノードにアタッチできるように導出できます。結果として、AddAnnotation メソッドは、指定されたノードにアタッチされた新しい注釈で構文ツリーのコピーを返します。
特定のノードに関する注釈情報を得るには、 HasAnnotations プロパティを使用して特定のノードに注釈があるかどうか、特定のノードにアタッチされた注釈を取得するための GetAnnotations オーバーロード メソッド、およびそのノードのサブツリー内に注釈のあるノードを列挙するための GetAnnotatedNodes オーバーロード メソッドがあるかどうかを判断します。ここで説明したメソッドはどちらも Type をとるオーバーロードを有するため、その SyntaxAnnotation インスタンスが特定のタイプであるまたは導出された注釈を持つノードまたは注釈を取得します。
以下は、構文ツリーに注釈のアタッチ方法例です。
Visual Basic の場合:
Dim document = New TextDocument()
document.Language = CSharpLanguage.Instance
' ...ドキュメントを解析します。
Dim originalTree = document.SyntaxTree
Dim node1 = originalTree.RootNode.GetChild(0)
Dim node2 = originalTree.RootNode.GetChild(1)
Dim annotatedTree = originalTree.AddAnnotation(node1, New SyntaxAnnotation())
Dim annotatedTreeAgain = annotatedTree.AddAnnotation(node2, New SyntaxAnnotation())C# の場合:
var document = new TextDocument();
document.Language = CSharpLanguage.Instance;
// ...ドキュメントを解析します。
var originalTree = document.SyntaxTree;
var node1 = originalTree.RootNode.GetChild(0);
var node2 = originalTree.RootNode.GetChild(1);
var annotatedTree = originalTree.AddAnnotation(node1, new SyntaxAnnotation());
var annotatedTreeAgain = annotatedTree.AddAnnotation(node2, new SyntaxAnnotation());注:
診断情報をアタッチするには、 Diagnostic と診断をアタッチするツリー ノードを取得する SyntaxTree の AddDiagnostic メソッドを使用します。結果として、AddDiagnostic メソッドは、指定されたノードにアタッチされた新しい注釈で構文ツリーのコピーを返します。
診断情報を取得するには、 ContainsDiagnostics プロパティと GetDiagnostics メソッドを SyntaxNode クラス上で使用します。これらのメソッドは、Syntax Parsing Engine の診断とカスタム診断を区別しないため、これらのメンバーはすべての診断情報を自動的にノードとその子孫から返します。
以下は、構文ツリーに診断のアタッチ方法例です。
Visual Basic の場合:
Dim document = New TextDocument()
document.Language = CSharpLanguage.Instance
' ...ドキュメントを解析します。
Dim syntaxNode = document.SyntaxTree.RootNode.GetChild(0)
Dim newTree = document.SyntaxTree.AddDiagnostic( _
syntaxNode, _
New Diagnostic( _
New TextSpan(syntaxNode.LeadingIgnoredContentLength, syntaxNode.GetText().Trim().Length), _
"Something wrong happened!", _
DiagnosticSeverity.Warning))C# の場合:
var document = new TextDocument();
document.Language = CSharpLanguage.Instance;
// ...ドキュメントを解析します。
var syntaxNode = document.SyntaxTree.RootNode.GetChild(0);
var newTree = document.SyntaxTree.AddDiagnostic(
syntaxNode,
new Diagnostic(
new TextSpan(syntaxNode.LeadingIgnoredContentLength, syntaxNode.GetText().Trim().Length),
"Something wrong happened!",
DiagnosticSeverity.Warning));解析操作が完了した後、 TextDocument に戻される前に、新しく作成された構文ツリーを取得するには、 LanguageBase クラスに定義される SyntaxTreeCreated イベントにハンドラーをアタッチします。 SyntaxTreeCreatedEventArgs クラスは取得/設定可能な SyntaxTree プロパティを公開します。このプロパティを AddAnnotation または AddDiagnostic メソッドから返された新しい SyntaxTree に設定できます。この方法で、カスタム診断および注釈を xamSyntaxEditor で表示できます。
以下は、 SyntaxTreeCreated イベントにイベント ハンドラーをアタッチする方法の例です。
Visual Basic の場合:
Me.xamSyntaxEditor1.Document.Language.SyntaxTreeCreated += Language_SyntaxTreeCreated
Private Sub Language_SyntaxTreeCreated(sender As Object, e As SyntaxTreeCreatedEventArgs)
Dim syntaxNode = e.SyntaxTree.RootNode.GetChild(0)
' 診断を追加
Dim newTree = e.SyntaxTree.AddDiagnostic(syntaxNode, New Diagnostic(New TextSpan(syntaxNode.LeadingIgnoredContentLength, syntaxNode.GetText().Trim().Length), "Something wrong happened!", DiagnosticSeverity.Warning))
' 注釈を追加
Dim anotherNewTree = newTree.AddAnnotation(newTree.RootNode.GetChild(0), New SyntaxAnnotation())
e.SyntaxTree = anotherNewTree
End SubC# の場合:
this.xamSyntaxEditor1.Document.Language.SyntaxTreeCreated += Language_SyntaxTreeCreated;
void Language_SyntaxTreeCreated(object sender, SyntaxTreeCreatedEventArgs e)
{
var syntaxNode = e.SyntaxTree.RootNode.GetChild(0);
// 診断を追加
var newTree = e.SyntaxTree.AddDiagnostic(
syntaxNode,
new Diagnostic(
new TextSpan(syntaxNode.LeadingIgnoredContentLength, syntaxNode.GetText().Trim().Length),
"Something wrong happened!",
DiagnosticSeverity.Warning));
// 注釈を追加
var anotherNewTree = newTree.AddAnnotation(
newTree.RootNode.GetChild(0), new SyntaxAnnotation());
e.SyntaxTree = anotherNewTree;
}このトピックの追加情報については、以下のトピックも合わせてご参照ください。