SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Metoda

Definice

Obor názvů:

System.Speech.Recognition

Sestavení:

System.Speech.dll

Balíček:

System.Speech v9.0.0-preview.3.24172.9

Zdroj:

SpeechRecognitionEngine.cs

Asynchronně načte gramatiku rozpoznávání řeči.

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)

Parametry

grammar

Grammar

Gramatika rozpoznávání řeči, která se má načíst.

Výjimky

ArgumentNullException

Grammar je null.

InvalidOperationException

Grammar není v platném stavu.

OperationCanceledException

Asynchronní operace byla zrušena.

Poznámky

Když rozpoznávání dokončí načítání objektu Grammar , vyvolá LoadGrammarCompleted událost. Rozpoznávání vyvolá výjimku, pokud Grammar je objekt již načten, je asynchronně načten nebo se nepodařilo načíst do žádného rozpoznávání. Stejný Grammar objekt nelze načíst do více instancí nástroje SpeechRecognitionEngine. Místo toho vytvořte nový Grammar objekt pro každou SpeechRecognitionEngine instanci.

Pokud je rozpoznávání spuštěné, musí aplikace před načtením, uvolněním, povolením nebo zakázáním gramatiky pozastavit RequestRecognizerUpdate modul rozpoznávání řeči.

Když načtete gramatiku, je ve výchozím nastavení povolená. Pokud chcete zakázat načtenou gramatiku Enabled , použijte vlastnost .

Pokud chcete načíst gramatiku rozpoznávání řeči synchronně, použijte metodu LoadGrammar .

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem LoadGrammar(Grammar).

Viz také

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