GrammarBuilder.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
2 つの文法要素のシーケンスを含む新しい GrammarBuilder を作成します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Add(Choices, GrammarBuilder) |
Choices オブジェクトとそれに続くGrammarBuilder オブジェクトを含む新しいGrammarBuilderを作成します。 |
| Add(GrammarBuilder, Choices) |
GrammarBuilder オブジェクトとそれに続くChoices オブジェクトを含む新しいGrammarBuilderを作成します。 |
| Add(GrammarBuilder, GrammarBuilder) |
2 つのGrammarBuilder オブジェクトのシーケンスを含む新しいGrammarBuilderを作成します。 |
| Add(GrammarBuilder, String) |
GrammarBuilder オブジェクトとそれに続く語句を含む新しいGrammarBuilderを作成します。 |
| Add(String, GrammarBuilder) |
語句の後にGrammarBuilder オブジェクトが続く新しいGrammarBuilderを作成します。 |
注釈
静的 Add メソッドは、さまざまな型を組み合わせて、 GrammarBuilderで構築された文法の多様性と柔軟性を生み出すことができる別のメカニズムを提供します。 これらのメソッドは、GrammarBuilder クラスでも定義されている静的Addition メソッドに対応します。 パラメーターの順序によって、新しい GrammarBuilder内の要素の順序が決まります。
GrammarBuilderは、Choices、SemanticResultKey、SemanticResultValue、および String オブジェクトから取得することもできます。 詳細については、 Implicit 演算子と Addition 演算子を参照してください。
Important
音声認識エンジンは、同じキー名を持つ重複するセマンティック要素または同じセマンティック要素の値を繰り返し変更できる複数のセマンティック要素を含む音声認識文法を使用するときに例外をスローする可能性があります。
音声認識文法の構築と使用の詳細については、「 音声認識」を参照してください。
Add(Choices, GrammarBuilder)
Choices オブジェクトとそれに続くGrammarBuilder オブジェクトを含む新しいGrammarBuilderを作成します。
public:
static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::Choices ^ choices, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add(System.Speech.Recognition.Choices choices, System.Speech.Recognition.GrammarBuilder builder);
static member Add : System.Speech.Recognition.Choices * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (choices As Choices, builder As GrammarBuilder) As GrammarBuilder
パラメーター
- choices
- Choices
代替のセットを表す最初の文法要素。
- builder
- GrammarBuilder
2 番目の文法要素。
戻り値
choices要素のシーケンスの後にbuilder要素が続くGrammarBuilder。
注釈
GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。
このメソッドは、 builder パラメーターに対して上記のオブジェクトを受け入れます。
詳細については、 Implicit 演算子と Addition 演算子を参照してください。
Important
SemanticResultValueまたはSemanticResultKeyインスタンスを含むChoicesオブジェクトとGrammarBuilderオブジェクトを組み合わせる場合は、同じキー名を持つ重複するセマンティック要素や、SemanticValue オブジェクトのValueプロパティを繰り返し変更できる複数のセマンティック要素を作成しないようにしてください。 音声認識エンジンは、このような状況が発生した場合に例外をスローする可能性があります。 セマンティック情報を含む音声認識文法の構築の詳細については、「 GrammarBuilder 文法にセマンティクスを追加する」を参照してください。
こちらもご覧ください
適用対象
Add(GrammarBuilder, Choices)
GrammarBuilder オブジェクトとそれに続くChoices オブジェクトを含む新しいGrammarBuilderを作成します。
public:
static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::Speech::Recognition::Choices ^ choices);
public static System.Speech.Recognition.GrammarBuilder Add(System.Speech.Recognition.GrammarBuilder builder, System.Speech.Recognition.Choices choices);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, choices As Choices) As GrammarBuilder
パラメーター
- builder
- GrammarBuilder
最初の文法要素。
- choices
- Choices
代替のセットを表す 2 番目の文法要素。
戻り値
builder要素のシーケンスの後にchoices要素が続くGrammarBuilder。
例
次の例では、2 つの語句 "背景色を作成する" と " 背景色を 色に設定" を認識できる音声認識文法を作成します。ここで、色は一連の 色 から選択されます。 String、Choices、GrammarBuilder オブジェクトなど、最終的な文法を構築するためにさまざまな型が使用されます。 Add メソッドの呼び出しでの明示的なキャスト演算子は省略可能です。
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase =
GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
GrammarBuilder setPhrase =
GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the grammar from the result.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
注釈
GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。
このメソッドは、 builder パラメーターに対して上記のオブジェクトを受け入れます。
詳細については、 Implicit 演算子と Addition 演算子を参照してください。
Important
SemanticResultValueまたはSemanticResultKeyインスタンスを含むChoicesオブジェクトとGrammarBuilderオブジェクトを他の文法要素と組み合わせる場合は、同じキー名を持つ重複するセマンティック要素や、SemanticValue オブジェクトのValueプロパティを繰り返し変更できる複数のセマンティック要素を作成しないようにしてください。 音声認識エンジンは、このような状況が発生した場合に例外をスローする可能性があります。
こちらもご覧ください
適用対象
Add(GrammarBuilder, GrammarBuilder)
2 つのGrammarBuilder オブジェクトのシーケンスを含む新しいGrammarBuilderを作成します。
public:
static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder1, System::Speech::Recognition::GrammarBuilder ^ builder2);
public static System.Speech.Recognition.GrammarBuilder Add(System.Speech.Recognition.GrammarBuilder builder1, System.Speech.Recognition.GrammarBuilder builder2);
static member Add : System.Speech.Recognition.GrammarBuilder * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder1 As GrammarBuilder, builder2 As GrammarBuilder) As GrammarBuilder
パラメーター
- builder1
- GrammarBuilder
最初の文法要素。
- builder2
- GrammarBuilder
2 番目の文法要素。
戻り値
builder1要素のシーケンスの後にbuilder2要素が続くGrammarBuilder。
例
次の例では、2 つの語句 "背景色を作成する" と " 背景色を 色に設定" を認識できる音声認識文法を作成します。ここで、色は一連の 色 から選択されます。 String、Choices、GrammarBuilder オブジェクトなど、最終的な文法を構築するためにさまざまな型が使用されます。 Add メソッドの呼び出しでの明示的なキャスト演算子は省略可能です。
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase =
GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
GrammarBuilder setPhrase =
GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the grammar from the result.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
注釈
GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。
このメソッドは、 builder1 または builder2 パラメーターに対して上記のオブジェクトを受け入れます。
詳細については、 Implicit 演算子と Addition 演算子を参照してください。
Important
SemanticResultValueまたはSemanticResultKeyインスタンスを含むChoicesオブジェクトとGrammarBuilderオブジェクトを他の文法要素と組み合わせる場合は、同じキー名を持つ重複するセマンティック要素や、SemanticValue オブジェクトのValueプロパティを繰り返し変更できる複数のセマンティック要素を作成しないようにしてください。 音声認識エンジンは、このような状況が発生した場合に例外をスローする可能性があります。
こちらもご覧ください
適用対象
Add(GrammarBuilder, String)
GrammarBuilder オブジェクトとそれに続く語句を含む新しいGrammarBuilderを作成します。
public:
static System::Speech::Recognition::GrammarBuilder ^ Add(System::Speech::Recognition::GrammarBuilder ^ builder, System::String ^ phrase);
public static System.Speech.Recognition.GrammarBuilder Add(System.Speech.Recognition.GrammarBuilder builder, string phrase);
static member Add : System.Speech.Recognition.GrammarBuilder * string -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (builder As GrammarBuilder, phrase As String) As GrammarBuilder
パラメーター
- builder
- GrammarBuilder
最初の文法要素。
- phrase
- String
単語のシーケンスを表す 2 番目の文法要素。
戻り値
builder要素のシーケンスの後にphrase要素が続くGrammarBuilder。
例
次の例では、2 つの語句 "背景色を作成する" と " 背景色を 色に設定" を認識できる音声認識文法を作成します。ここで、色は一連の 色 から選択されます。 String、Choices、GrammarBuilder オブジェクトなど、最終的な文法を構築するためにさまざまな型が使用されます。 Add メソッドの呼び出しでの明示的なキャスト演算子は省略可能です。
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase =
GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
GrammarBuilder setPhrase =
GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the grammar from the result.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
注釈
GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。
このメソッドは、 builder パラメーターに対して上記のオブジェクトを受け入れます。
詳細については、 Implicit 演算子と Addition 演算子を参照してください。
こちらもご覧ください
適用対象
Add(String, GrammarBuilder)
語句の後にGrammarBuilder オブジェクトが続く新しいGrammarBuilderを作成します。
public:
static System::Speech::Recognition::GrammarBuilder ^ Add(System::String ^ phrase, System::Speech::Recognition::GrammarBuilder ^ builder);
public static System.Speech.Recognition.GrammarBuilder Add(string phrase, System.Speech.Recognition.GrammarBuilder builder);
static member Add : string * System.Speech.Recognition.GrammarBuilder -> System.Speech.Recognition.GrammarBuilder
Public Shared Function Add (phrase As String, builder As GrammarBuilder) As GrammarBuilder
パラメーター
- phrase
- String
単語のシーケンスを表す最初の文法要素。
- builder
- GrammarBuilder
2 番目の文法要素。
戻り値
phrase要素のシーケンスの後にbuilder要素が続くGrammarBuilder。
例
次の例では、2 つの語句 "背景色を作成する" と " 背景色を 色に設定" を認識できる音声認識文法を作成します。ここで、色は一連の 色 から選択されます。 String、Choices、GrammarBuilder オブジェクトなど、最終的な文法を構築するためにさまざまな型が使用されます。 Add メソッドの呼び出しでの明示的なキャスト演算子は省略可能です。
private Grammar CreateColorGrammar()
{
// Create a set of color choices.
Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
// Create grammar builders for the two versions of the phrase.
GrammarBuilder makePhrase =
GrammarBuilder.Add((GrammarBuilder)"Make background", colorChoice);
GrammarBuilder setPhrase =
GrammarBuilder.Add("Set background to", (GrammarBuilder)colorChoice);
// Create a Choices for the two alternative phrases, convert the Choices
// to a GrammarBuilder, and construct the grammar from the result.
Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);
Grammar grammar = new Grammar(bothPhrases);
grammar.Name = "backgroundColor";
return grammar;
}
注釈
GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。
このメソッドは、 builder パラメーターに対して上記のオブジェクトを受け入れます。
詳細については、 Implicit 演算子と Addition 演算子を参照してください。