GrammarBuilder Klasse

Definition

public ref class GrammarBuilder

public class GrammarBuilder

type GrammarBuilder = class

Public Class GrammarBuilder

Vererbung

Object

GrammarBuilder

Beispiele

Im folgenden Beispiel GrammarBuilder werden-und-Objekte verwendet, Choices um eine Grammatik zu erstellen, die einen der beiden Ausdrücke, "Make background colorchoice" oder "Set Background on colorchoice", erkennen kann.

Im Beispiel wird ein- Choices Objekt verwendet, um eine Liste zulässiger Werte für colorchoice aus einem Array von-Objekten zu erstellen String . Ein Choices -Objekt ist analog zum one-of -Element in der SRGS-Spezifikation und enthält eine Reihe alternativer Ausdrücke, von denen jedes beim sprechen erkannt werden kann. Im Beispiel wird auch ein- Choices Objekt verwendet, um ein Array von zwei- GrammarBuilder Objekten in ein paar alternativer Ausdrücke zu gruppieren, die die resultierende Grammatik erkennen kann. Alternative Wörter oder Ausdrücke sind eine Komponente der meisten Grammatiken, und das- Choices Objekt stellt diese Funktionalität für Grammatiken bereit, die mit erstellt wurden GrammarBuilder .

Im Beispiel wird schließlich ein- Grammar Objekt aus einem erstellt, das GrammarBuilder aus einem-Objekt erstellt wurde 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;  
}  

Hinweise

Sprach Erkennungs Grammatiken werden häufig in dem XML-Format erstellt, das in der sprach Erkennungs Grammatik-Spezifikation (SRGS), Version 1,0, definiert ist. Wenn Sie mit SRGS vertraut sind, die Grammatiken aber Programm gesteuert generieren möchten, können Sie den- System.Speech.Recognition.SrgsGrammar Namespace verwenden, dessen Member genau den Elementen und Attributen entsprechen, die von SRGS definiert werden. Wenn Sie mit SRGS nicht vertraut sind oder einen einfachen, programmgesteuerten Ansatz zur Erstellung von Grammatiken wünschen, mit denen Sie viele gängige Szenarien effizient erledigen können. Sie können die GrammarBuilder -Klasse und die- Choices Klasse verwenden.

Verwenden GrammarBuilder Sie-Objekte, um eine hierarchische Struktur zu erstellen, Choices die aus Objekten besteht, die Alternative Ausdrücke enthalten, die mit Präambel und Post-sprechenden Ausdrücken an jedem Knoten kombiniert werden, und mit semantischen Werten, die die Bedeutung zurück an die Anwendung vermitteln.

GrammarBuilder Grammar Verwenden Sie die folgenden Schritte, um ein-Objekt zum Erstellen eines-Objekts zu verwenden.

1. Erstellen eines GrammarBuilder-Objekts

2. Fügen Sie Einschränkungen an GrammarBuilder , z. b. String Objekte, Choices , SemanticResultKey , SemanticResultValue , DictationGrammar und andere Objekte, die GrammarBuilder die Einschränkungen für die Grammatik definieren.

3. Verwenden Sie einen der- Grammar Konstruktoren, um ein- Grammar Objekt aus der abgeschlossenen Grammatik zu erstellen GrammarBuilder .

Die Erstellung mit GrammarBuilder eignet sich am besten für Grammatiken, die eine einzelne Regel mit Listen oder vielleicht Listen von Listen aufweisen. Wenn Sie Grammatiken Programm gesteuert erstellen möchten, die über mehrere Regeln verfügen oder interne Regel Verweise erstellen müssen, verwenden Sie die Klassen des- System.Speech.Recognition.SrgsGrammar Namespace.

Instanzen von GrammarBuilder können auch durch implizite Konvertierungen von bestimmten anderen Klassen oder durch Kombinieren eines GrammarBuilder mit einem zweiten Objekt abgerufen werden, das Einschränkungen für eine Grammatik enthält. Weitere Informationen finden Sie unter den Implicit Addition Operatoren und und den- Add Methoden.

Um einer vorhandenen Regeln hinzuzufügen GrammarBuilder , verwenden Sie Add die Append Methoden,, AppendDictation , AppendRuleReference und AppendWildcard .

Um das Debuggen zu unterstützen, gibt die- DebugShowPhrases Eigenschaft den aktuellen Status von GrammarBuilder als Zeichenfolge zurück.

Konstruktoren

Eigenschaften

Methoden

Operatoren

Gilt für

Siehe auch

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue