SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Grammar
je null
.
Grammar
není v platném stavu.
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).