GrammarBuilder Constructor (String)

Constructs a GrammarBuilder object from a phrase expressed as a string.

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

Syntax

'Declaration
Public Sub New ( _
    phrase As String _
)

public GrammarBuilder (
    string phrase
)

public:
GrammarBuilder (
    String^ phrase
)

public GrammarBuilder (
    String phrase
)

public function GrammarBuilder (
    phrase : String
)

Parameters

• phrase
  A valid System.String instance containing a phrase to be used to construct a new instance of GrammarBuilder.

Example

The code sample below constructs a Grammar which recognizes either of two phrases: "Make background [color]" or "Configure background as [color]" using a explicit creation of and implicit conversion to GrammarBuilder instances.

The explicit construction of a GrammarBuilder object from a System.String instance is highlighted in the example code below.

private Grammar CreateGrammarBuilderRGBSemantics(params int[] info) {
    //Create a set of choices, each  a lookup from a color name to RGB
    //Choices constructors do not take SematicResultValue, so cast SematicResultValue to GramarBuilder
    Choices colorChoice = new Choices();
    foreach (string colorName in System.Enum.GetNames(typeof(KnownColor))) {
        colorChoice.Add((GrammarBuilder)
                                (new SemanticResultValue(colorName, Color.FromName(colorName).ToARGB())));
    }

    GrammarBuilder choiceBuilder = new SemanticResultKey("RGB", colorChoice);
    //Create two intermediate grammars with introductory phrase and the color choice
    GrammarBuilder makeBackgroundBuilder = "Make background";
    //Uses implicit conversion of SystemString to GrammarBuilder
    makeBackgroundBuilder.Append(choiceBuilder);
    GrammarBuilder configureBackgroundBuilder = new GrammarBuilder("Configure background as");
//Construct GrammarBuilder from string.
    configureBackgroundBuilder.Append(new SemanticResultKey("RGB", colorChoice));

    //Create the final grammar, which recognizes either intermediate grammar
    Grammar grammar = new Grammar(new Choices(makeBackgroundBuilder, configureBackgroundBuilder));
    /
    grammar.Name = "Make Background /Configure background as";

    return grammar;
}

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

See Also

Reference

GrammarBuilder Class
GrammarBuilder Members
Microsoft.Speech.Recognition Namespace