Add Method (String, GrammarBuilder)

Microsoft Speech Platform SDK 11

previous page next page

Creates a new GrammarBuilder that contains a phrase followed by a GrammarBuilder object.

Namespace: Microsoft.Speech.Recognition
Assembly: Microsoft.Speech (in Microsoft.Speech.dll)

Syntax

Visual Basic (Declaration)
Public Shared Function Add ( _ phrase As String, _ builder As GrammarBuilder _ ) As GrammarBuilder

Visual Basic (Usage)
Dim phrase As String Dim builder As GrammarBuilder Dim returnValue As GrammarBuilder returnValue = GrammarBuilder.Add(phrase, builder)

C#
public static GrammarBuilder Add( string phrase, GrammarBuilder builder )

Parameters

phrase: Type: System..::..String
The first grammar element, which represents a sequence of words.

builder: Type: Microsoft.Speech.Recognition..::..GrammarBuilder
The second grammar element.

Return Value

Type: Microsoft.Speech.Recognition..::..GrammarBuilder

A GrammarBuilder for the sequence of the phrase element followed by the builder element.

Remarks

GrammarBuilder supports implicit conversions from the following classes:

This method accepts the objects listed above for the builder parameter.

For more information, see the ImplicitWideningImplicitImplicitImplicit and Addition operators.

Examples

The following example creates a speech recognition grammar that can recognize the two phrases, "Make background color" and "Set background to color", where color is selected from a set of colors. Various types are used to build the final grammar, such as String, Choices, and GrammarBuilder objects. The explicit cast operators in the calls to the Add methods are optional.

C#	Copy Code
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; }

Copy Code

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;
}