Choices.ToGrammarBuilder Method ()


Returns a GrammarBuilder object from this Choices object.

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

public GrammarBuilder ToGrammarBuilder()

Return Value

Type: System.Speech.Recognition.GrammarBuilder

A GrammarBuilder that matches this Choices object.

The GrammarBuilder returned by this method is equivalent to one returned by either of the following.

  • Calling the GrammarBuilder constructor with this object as the parameter.

  • Using the implicit or explicit cast of this object to a GrammarBuilder.

The following example creates a speech recognition grammar for changing the background color.

private Grammar CreateColorChoice()

  // Create a Choices object that contains a set of alternative colors.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder();
  gb.Append(new Choices(new string[] {"Set", "Change"}));
  gb.Append("background to");

  Grammar grammar = new Grammar(gb);
  grammar.Name = "modify background color";

  return grammar;

.NET Framework
Available since 3.0
Return to top