SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Methode

Definition

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paket:

System.Speech v9.0.0-preview.3.24172.9

Quelle:

SpeechRecognitionEngine.cs

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 -> unit

Public Sub LoadGrammarAsync (grammar As Grammar)

Parameter

grammar

Grammar

Die zu ladende Spracherkennungsgrammatik.

Ausnahmen

ArgumentNullException

Grammar ist null.

InvalidOperationException

Grammar ist in keinem gültigen Zustand.

OperationCanceledException

Der asynchrone Vorgang wurde abgebrochen.

Hinweise

Wenn die Erkennung das Laden eines Grammar Objekts abgeschlossen hat, löst sie ein Ereignis aus LoadGrammarCompleted . Die Erkennung löst eine Ausnahme aus, wenn das Grammar Objekt bereits geladen ist, asynchron geladen wird oder nicht in eine Erkennung geladen wurde. Sie können dasselbe Grammar Objekt nicht in mehrere Instanzen von SpeechRecognitionEngineladen. Erstellen Sie stattdessen ein neues Grammar Objekt für jede SpeechRecognitionEngine instance.

Wenn die Erkennung ausgeführt wird, müssen RequestRecognizerUpdate Anwendungen verwenden, um die Spracherkennungs-Engine vor dem Laden, Entladen, Aktivieren oder Deaktivieren einer Grammatik anzuhalten.

Wenn Sie eine Grammatik laden, ist sie standardmäßig aktiviert. Verwenden Sie die Enabled -Eigenschaft, um eine geladene Grammatik zu deaktivieren.

Verwenden Sie die LoadGrammar -Methode, um eine Spracherkennungsgrammatik synchron zu laden.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten LoadGrammar(Grammar)Ausnahmen.

Weitere Informationen

• LoadGrammarCompleted
• RecognizerUpdateReached
• LoadGrammar(Grammar)
• UnloadAllGrammars()
• UnloadGrammar(Grammar)