SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Methode
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.
Lädt asynchron eine Spracherkennungsgrammatik.
public:
void LoadGrammarAsync(System::Speech::Recognition::Grammar ^ grammar);public void LoadGrammarAsync(System.Speech.Recognition.Grammar grammar);member this.LoadGrammarAsync : System.Speech.Recognition.Grammar -> unitPublic Sub LoadGrammarAsync (grammar As Grammar)Parameter
- grammar
- Grammar
Die zu ladende Spracherkennungsgrammatik.
Ausnahmen
Grammar ist null.
Grammar ist nicht in einem gültigen Zustand.
Der asynchrone Vorgang wurde abgebrochen.
Hinweise
Wenn die Erkennung das Laden eines Grammar Objekts abgeschlossen hat, löst sie ein LoadGrammarCompleted Ereignis aus. Die Erkennung löst eine Ausnahme aus, wenn das Grammar Objekt bereits geladen wurde, asynchron geladen wird oder nicht in eine Erkennung geladen wurde. Sie können dasselbe Grammar Objekt nicht in mehrere Instanzen von SpeechRecognitionEngine. Erstellen Sie stattdessen für jede SpeechRecognitionEngine Instanz ein neues Grammar Objekt.
Wenn die Erkennung ausgeführt wird, müssen Anwendungen das Spracherkennungsmodul vor dem Laden, Entladen, Aktivieren oder Deaktivieren einer Grammatik anhalten RequestRecognizerUpdate .
Wenn Sie eine Grammatik laden, ist sie standardmäßig aktiviert. Verwenden Sie die Enabled Eigenschaft, um eine geladene Grammatik zu deaktivieren.
Um eine Spracherkennungsgrammatik synchron zu laden, verwenden Sie die LoadGrammar Methode.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von LoadGrammar(Grammar).
