GrammarBuilder Klass

Definition

public ref class GrammarBuilder

public class GrammarBuilder

type GrammarBuilder = class

Public Class GrammarBuilder

Arv

Object

GrammarBuilder

Exempel

I följande exempel används GrammarBuilder och Choices objekt för att konstruera en grammatik som kan känna igen någon av de två fraserna, "Make background colorChoice" eller "Set background to colorChoice".

I exemplet används ett Choices objekt för att skapa en lista med acceptabla värden för colorChoice från en matris med String objekt. Ett Choices objekt motsvarar elementet one-of i SRGS-specifikationen och innehåller en uppsättning alternativa fraser, som alla kan identifieras när de talas. I exemplet används också ett Choices objekt för att gruppera en matris med två GrammarBuilder objekt i ett par alternativa fraser som den resulterande grammatiken kan känna igen. Alternativa ord eller fraser är en komponent i de flesta grammatiker, och objektet tillhandahåller den Choices här funktionen för grammatik som konstruerats med GrammarBuilder.

Exemplet skapar slutligen ett Grammar objekt från ett GrammarBuilder konstruerat objekt Choices .

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);

  // Create grammar builders for the two versions of the phrase.
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");
  makePhrase.Append(colorElement);
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");
  setPhrase.Append(colorElement);

  // 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});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

Kommentarer

Grammatik för taligenkänning är ofta författade i XML-format som definieras av SRGS version 1.0 (Taligenkänningsmatikspecifikation). Om du är bekant med SRGS men vill generera grammatiken programmatiskt kan du använda System.Speech.Recognition.SrgsGrammar namnområdet, vars medlemmar motsvarar de element och attribut som definieras av SRGS. Om du inte är bekant med SRGS, eller om du vill ha en enkel, programmatisk metod för att redigera grammatik som du effektivt kan utföra många vanliga scenarier med. du kan använda klasserna GrammarBuilder och Choices .

Använd GrammarBuilder objekt för att skapa ett hierarkiskt träd som består av Choices objekt som innehåller alternativa fraser, varvat med ingresser och post-amble-fraser på varje nod och som är seedade med semantiska värden som förmedlar mening tillbaka till programmet.

Använd följande steg om du vill använda en GrammarBuilder för att skapa ett Grammar objekt.

1. Skapa ett GrammarBuilder objekt.

2. Lägg till begränsningar i GrammarBuilder, till exempel String objekt, Choices, SemanticResultKey, SemanticResultValue, DictationGrammaroch andra GrammarBuilder objekt som definierar begränsningarna för grammatiken.

3. Använd en av konstruktorerna Grammar för att skapa ett Grammar objekt från den slutförda GrammarBuilder grammatiken.

Redigering med GrammarBuilder passar bäst för grammatiker som har en enda regel som innehåller listor, eller kanske listor med listor. Om du vill skapa grammatik programmatiskt som har flera regler, eller som behöver göra interna regelreferenser, använder du namnområdets System.Speech.Recognition.SrgsGrammar klasser.

Instanser av GrammarBuilder kan också hämtas genom implicita konverteringar från vissa andra klasser eller genom att kombinera ett GrammarBuilder med ett andra objekt som innehåller begränsningar för en grammatik.. Mer information finns i operatorerna Implicit och Addition och Add metoderna.

Om du vill lägga till regler i en befintlig GrammarBuilderanvänder du Addmetoderna , Append, AppendDictation, AppendRuleReferenceoch AppendWildcard .

För att hjälpa till med felsökning returnerar DebugShowPhrases egenskapen den aktuella statusen för GrammarBuilder som en sträng.

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue