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 jakéhokoli nástroje pro rozpoznávání. Stejný Grammar objekt nelze načíst do více instancí 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 RequestRecognizerUpdate načtením, uvolněním, povolením nebo zakázáním gramatiky pozastavit modul pro 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 tuto vlastnost.
Pokud chcete synchronně načíst gramatiku rozpoznávání řeči, použijte metodu LoadGrammar .
Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané LoadGrammar(Grammar).