Choices.ToGrammarBuilder Method

Reference

Definition

Namespace:: System.Speech.Recognition

Assembly:: System.Speech.dll

Package:: System.Speech v8.0.0

Package:: System.Speech v9.0.0-rc.2.24473.5

Source:: Choices.cs

Source:: Choices.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns a GrammarBuilder object from this Choices object.

public:
 System::Speech::Recognition::GrammarBuilder ^ ToGrammarBuilder();

public System.Speech.Recognition.GrammarBuilder ToGrammarBuilder ();

member this.ToGrammarBuilder : unit -> System.Speech.Recognition.GrammarBuilder

Public Function ToGrammarBuilder () As GrammarBuilder

Returns

GrammarBuilder

A GrammarBuilder that matches this Choices object.

Examples

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");  
  gb.Append(colorChoice.ToGrammarBuilder());  

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

  return grammar;  
}

Remarks

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.

Applies to

Jagamisviis: