文章校正解析 (Syntax Parsing Engine)

トピックの概要

目的

このグループのトピックでは、Syntax Parsing Engine が行う文章校正解析について説明します。

前提条件

このトピックを理解するためには、以下のトピックを理解しておく必要があります。

トピック	目的
Syntax Parsing Engine の概要	このトピックは、Syntax Parsing Engine の概要を示します。
文書校正の概要	このトピックは、Syntax Parsing Engine の文章校正の概要を示します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

文章校正の解析
文章校正解析の要点
警告の取得
関連コンテンツ

文章校正の解析

文章校正解析のサマリー

文章校正の定義では許可されないことが多くあります (詳細は「制限」トピックを参照)。しかし、その他に許可されるものはありますが文章校正ライターが意図したものではない、または字句アナライザーや構文アナライザーを遅くすることになる可能性があります。以下に、文章解析中に強調表示されるこのような問題およびその回避方法を示します。

警告の取得

文章校正定義でその問題を判断するには、 Grammar.Analyze メソッドを使用し、型 GrammarAnalysisOptions のインスタンスを渡して解析を構成できます。

注:

Note	`GrammarAnalysisOptions` オブジェクトを指定しない場合、Syntax Parsing Engine はデフォルトのオプションセットで使用します。

GrammarAnalysisOptions には、以下の構成可能オプションが含まれます。

プロパティ:

プロパティ	説明
AnalyzeForAmbiguity	あいまいさ警告に対する文章校正を解析するかどうかを示します。この値のデフォルトは `true` です。
AnalyzeForComplexNonTerminalSymbol	ComplexNonTerminalSymbol 警告に対する文章校正を解析するかどうかを示します。この値のデフォルトは `true` です。
AnalyzeForSymbolCannotBeParsed	SymbolCannotBeParsed 警告に対する文章校正を解析するかどうかを示します。この値のデフォルトは `true` です。
AnalyzeForUnnecessarySyntaxRule	UnnecessarySyntaxRule 警告に対する文章校正を解析するかどうかを示します。この値のデフォルトは `true` です。
ComplexNonTerminalSymbolProductionLimit	複雑であるとみなされる前に NonTerminalSymbol が所有しなければならない最小の生産数この値のデフォルトは 100 です。

このメソッドの戻り値は型 GrammarAnalysisResult のインスタンスです。文章校正および型 GrammarWarning のオブジェクトを含む Warnings コレクションを含みます。GrammarWarning タイプには、文字列型の記述的な Message と、型 GrammarWarningType の Type プロパティがあります。これは以下の値を持つ列挙体です。

値	説明
`Ambiguity`	文章校正の生産により特定のテキストの解析時にあいまいさが発生するタイミングを示します。詳細については、「あいまいさ」のトピックを参照してください。あいまいさが受け付け可能であると分かっており、警告は文章校正を解析することにより作成される警告をクラッターする場合、あいまいさに関わる非終端記号のいずれかにおいて NonTerminalSymbol.SuppressAmbiguityWarnings プロパティを `true` に設定することで抑制できます。
`ComplexNonTerminalSymbol`	非終端記号用のルールツリーが内部的に 100 生産を超えるよう拡張されるときを示します。ただしこの制限は GrammarAnalysisOptions で構成できます。複雑な非終端記号があると、構文アナライザーやエラーレポートの生成プロセスが格段に遅くなります。
`SymbolCannotBeParsed`	文章校正で定義された非終端記号または重要な終端記号が直接または間接的に開始記号で参照されないことを示します。これは、構文ツリーで表しているノードがないことを意味します。
`UnnecessarySyntaxRule`	以下のような、構文ルールが不要な場合を示します。 ConcatenationSyntaxRule 内で EmptySyntaxRule を使用記号シーケンスに空を連結することは、記号シーケンスを持つのと同じです。自身が OptionalSyntaxRule または RepetitionSyntaxRule の子である AlternationSyntaxRule 内で `EmptySyntaxRule` を使用オプションまたは繰り返しのルールは、指定されるものに加えてオルタナティブの 1 つが空のルールであることが示唆されます。指定は不要です。 FactorSyntaxRule には、 Rule プロパティとして `RepetitionSyntaxRule` のインスタンスがあります。ゼロ個以上の固定の数を有することは、ゼロ個以上を有することと同じです。そのため、`FactorSyntaxRule` を使用する必要は無く、`RepetitionSyntaxRule` は所定の位置で使用できます。

トピック	目的
制限	このトピックでは、文章校正の定義に関する制限を説明します。
あいまいさ	このトピックでは、ドキュメントの解析中に発生しうる曖昧さおよびその取扱方法について説明します。
字句解析の概要	このグループのトピックでは、Syntax Parsing Engine が行う字句解析について説明します。
構文解析の概要	このグループのトピックでは、Syntax Parsing Engine が行う構文解析について説明します。

WPF | ヘルプ トピック