GrammarBuilder.Add メソッド

定義

名前空間:

System.Speech.Recognition

アセンブリ:

System.Speech.dll

パッケージ:

System.Speech v9.0.0-preview.3.24172.9

2 つの文法要素のシーケンスを含む新しい GrammarBuilder を作成します。

オーバーロード

Add(Choices, GrammarBuilder)	GrammarBuilder オブジェクトが後続している Choices オブジェクトを含んでいる、新しい GrammarBuilder を作成します。
Add(GrammarBuilder, Choices)	Choices オブジェクトが後続している GrammarBuilder オブジェクトを含んでいる、新しい GrammarBuilder を作成します。
Add(GrammarBuilder, GrammarBuilder)	2 つの GrammarBuilder オブジェクトのシーケンスを含む新しい GrammarBuilder を作成します。
Add(GrammarBuilder, String)	GrammarBuilder オブジェクトとその後ろにフレーズを含む新しい GrammarBuilder を作成します。
Add(String, GrammarBuilder)	フレーズとその後ろに GrammarBuilder オブジェクトを含む新しい GrammarBuilder を作成します。

注釈

静的 Add メソッドは、さまざまな型を組み合わせて、 を使用して構築された GrammarBuilder文法の多様性と柔軟性を生み出す別のメカニズムを提供します。 これらのメソッドは静的 Addition メソッドに対応し、 クラスでも定義 GrammarBuilder されます。 パラメーターの順序によって、新しい GrammarBuilder内の要素の順序が決まります。

はGrammarBuilder、、SemanticResultKeySemanticResultValue、および String オブジェクトからChoices取得することもできます。 詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

重要

音声認識エンジンは、同じキー名または同じセマンティック要素の値を繰り返し変更できる複数のセマンティック要素を持つ重複するセマンティック要素を含む音声認識文法を使用すると、例外をスローできます。

音声認識文法の構築と使用の詳細については、「 音声認識」を参照してください。

Add(Choices, GrammarBuilder)

ソース:

GrammarBuilder.cs

GrammarBuilder オブジェクトが後続している Choices オブジェクトを含んでいる、新しい 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

代替候補セットを表す、最初の grammer 要素。

builder

GrammarBuilder

2 番目の grammer 要素。

戻り値

GrammarBuilder

builder 要素が後続している choices 要素のシーケンスのGrammarBuilder。

注釈

GrammarBuilder では、次のクラスからの暗黙的な変換がサポートされています。

• Choices

• SemanticResultKey

• SemanticResultValue

• String

このメソッドは、 パラメーターに対して上記のオブジェクトを builder 受け入れます。

詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

重要

または SemanticResultKey インスタンスを含む SemanticResultValue オブジェクトと GrammarBuilder を組み合わせるChoices場合は、同じキー名またはオブジェクトのプロパティを繰り返し変更できる複数のセマンティック要素で重複するセマンティック要素をValueSemanticValue作成しないようにしてください。 このような状況が発生した場合、音声認識エンジンは例外をスローできます。 セマンティック情報を含む音声認識文法の構築の詳細については、「 GrammarBuilder 文法にセマンティクスを追加する」を参照してください。

こちらもご覧ください

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, Choices)

ソース:

GrammarBuilder.cs

Choices オブジェクトが後続している GrammarBuilder オブジェクトを含んでいる、新しい 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 番目の文法要素で、代替のセットを表します。

戻り値

GrammarBuilder

choices 要素が後続している 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 では、次のクラスからの暗黙的な変換がサポートされています。

• Choices

• SemanticResultKey

• SemanticResultValue

• String

このメソッドは、 パラメーターに対して上記のオブジェクトを builder 受け入れます。

詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

重要

または SemanticResultKey インスタンスを含む SemanticResultValue オブジェクトと GrammarBuilder を他の文法要素と組み合わせるChoices場合は、オブジェクトの プロパティを繰り返し変更できる同じキー名または複数のセマンティック要素を使用して重複するセマンティック要素をValueSemanticValue作成しないようにしてください。 このような状況が発生した場合、音声認識エンジンは例外をスローできます。

こちらもご覧ください

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, GrammarBuilder)

ソース:

GrammarBuilder.cs

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 番目の grammer 要素。

戻り値

GrammarBuilder

builder2 要素が後続している builder1 要素のシーケンスの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 では、次のクラスからの暗黙的な変換がサポートされています。

• Choices

• SemanticResultKey

• SemanticResultValue

• String

このメソッドは、 または builder2 パラメーターに対して上記のオブジェクトをbuilder1受け入れます。

詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

重要

または SemanticResultKey インスタンスを含む SemanticResultValue オブジェクトと GrammarBuilder を他の文法要素と組み合わせるChoices場合は、オブジェクトの プロパティを繰り返し変更できる同じキー名または複数のセマンティック要素を使用して重複するセマンティック要素をValueSemanticValue作成しないようにしてください。 このような状況が発生した場合、音声認識エンジンは例外をスローできます。

こちらもご覧ください

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(GrammarBuilder, String)

ソース:

GrammarBuilder.cs

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 番目の文法要素で、言葉のシーケンスを表します。

戻り値

GrammarBuilder

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 では、次のクラスからの暗黙的な変換がサポートされています。

• Choices

• SemanticResultKey

• SemanticResultValue

• String

このメソッドは、 パラメーターに対して上記のオブジェクトを builder 受け入れます。

詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

こちらもご覧ください

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)

Add(String, GrammarBuilder)

ソース:

GrammarBuilder.cs

フレーズとその後ろに 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 番目の grammer 要素。

戻り値

GrammarBuilder

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 では、次のクラスからの暗黙的な変換がサポートされています。

• Choices

• SemanticResultKey

• SemanticResultValue

• String

このメソッドは、 パラメーターに対して上記のオブジェクトを builder 受け入れます。

詳細については、 演算子と Addition 演算子に関するページをImplicit参照してください。

こちらもご覧ください

• Append(Choices)
• Implicit(Choices to GrammarBuilder)
• Addition(Choices, GrammarBuilder)