構文ツリーから情報を取得するには、ツリー上にも情報を保存します。ツリー内の SyntaxTree およびすべてのオブジェクトは不変であり、そのため追加情報を保存する唯一の方法は、含まれる追加データのあるツリーのコピーを作成することです。これは、診断情報 (セマンティック エラーまたは警告など) または注釈のために実施します。どの種類のデータでもかまいません。このデータをツリーにアタッチできるメソッドは、SyntaxTree 上で定義されます。
注:
注釈をアタッチするには、SyntaxTree の AddAnnotation メソッドを使用して、アタッチする SyntaxAnnotation を提供します。SyntaxAnnotation クラスは、いずれかのデータをノードにアタッチできるように導出できます。結果として、AddAnnotation メソッドは、指定されたノードにアタッチされた新しい注釈で構文ツリーのコピーを返します。
特定のノードに関する注釈情報を得るには、 HasAnnotations プロパティを使用して特定のノードに注釈があるかどうか、特定のノードにアタッチされた注釈を取得するための GetAnnotations オーバーロード メソッド、およびそのノードのサブツリー内に注釈のあるノードを列挙するための GetAnnotatedNodes オーバーロード メソッドがあるかどうかを判断します。ここで説明したメソッドはどちらも Type をとるオーバーロードを有するため、その 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 の診断とカスタム診断を区別しないため、これらのメンバーはすべての診断情報を自動的にノードとその子孫から返します。
このトピックの追加情報については、以下のトピックも合わせてご参照ください。