Grammar.Priority Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert der Priorität eines Grammar-Objekts ab oder legt diesen fest.
public:
property int Priority { int get(); void set(int value); };public int Priority { get; set; }member this.Priority : int with get, setPublic Property Priority As IntegerEigenschaftswert
Die Priority-Eigenschaft gibt einen ganzzahligen Wert zurück, der die relative Priorität einer bestimmten Grammar darstellt. Der Bereich reicht von -128 bis 127 (inklusive). Die Standardeinstellung ist 0.
Beispiele
Im folgenden Beispiel werden zwei Grammar Objekte erstellt, eine für Ziffern und eine für Brüche. Die Grammar Objekte werden Namen und relative Gewichtungen und Prioritäten zugewiesen und von einer In-Process-Spracherkennung geladen. Die CreateDigitsGrammarMethoden CreateFractionsGrammar, und recognizer_SpeechRecognized Methoden werden hier nicht angezeigt.
// Create a Grammar for recognizing numeric digits.
Grammar digitsGrammar = CreateDigitsGrammar();
digitsGrammar.Name = "Digits Grammar";
digitsGrammar.Priority = 2;
digitsGrammar.Weight = 0.6f;
// Create a Grammar for recognizing fractions.
Grammar fractionsGrammar = CreateFractionsGrammar();
fractionsGrammar.Name = "Fractions Grammar";
fractionsGrammar.Priority = 1;
fractionsGrammar.Weight = 1f;
// Create an in-process speech recognizer.
SpeechRecognitionEngine recognizer = new SpeechRecognitionEngine();
recognizer.SpeechRecognized +=
new EventHandler<SpeechRecognizedEventArgs>(
recognizer_SpeechRecognized);
// Load the digits and fractions Grammar objects.
recognizer.LoadGrammar(digitsGrammar);
recognizer.LoadGrammar(fractionsGrammar);
// Start recognition.
recognizer.SetInputToDefaultAudioDevice();
recognizer.RecognizeAsync(RecognizeMode.Multiple);
Hinweise
Die Priority Eigenschaft wird verwendet, um eine Grammatik auszuwählen, wenn mehrere Grammatiken ein identisches Erkennungsergebnis erzeugen. Wenn eine Spracherkennung mehr als eine Spracherkennungsgrammatik geladen und aktiviert hat, die der Eingabe entspricht, und die Übereinstimmung das beste Ergebnis aus der Erkennung ist, verwendet die Erkennung die Grammatik, die die höchste Priorityhat. Wenn die Grammatiken, die das identische Erkennungsergebnis erzeugen, auch denselben Priority Wert haben, ist die Grammatik, die die Erkennung verwendet, nicht definiert.