GrammarBuilder Constructor (String, Int32, Int32)

GrammarBuilder Constructor (String, Int32, Int32)


Initializes a new instance of the GrammarBuilder class from the sequence of words in a String and specifies how many times the String can be repeated.

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

public GrammarBuilder(
	string phrase,
	int minRepeat,
	int maxRepeat


Type: System.String

The repeated sequence of words.

Type: System.Int32

The minimum number of times that input matching the phrase must occur to constitute a match.

Type: System.Int32

The maximum number of times that input matching the phrase can occur to constitute a match.

If the value of minRepeat is 0, then the new GrammarBuilder represents an optional element.

The value of minRepeat must be greater than or equal to 0 and less than or equal to the value of maxRepeat. For more information about building a speech recognition grammar that contains strings, see .0d87b445-a342-4369-9b3f-91d07fd7e114

The following example creates a speech recognition grammar for ordering a pizza. It starts with an optional, opening phrase, followed by one to four toppings, and closes with the word "pizza".

private static Grammar CreatePizzaGrammar()

  // Create a Choices object with alternatives for toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;

.NET Framework
Available since 3.0
Return to top
© 2015 Microsoft