SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie ładuje gramatykę rozpoznawania mowy.
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
Gramatyka rozpoznawania mowy do załadowania.
Wyjątki
Grammar
to null
.
Grammar
nie jest w prawidłowym stanie.
Operacja asynchroniczna została anulowana.
Uwagi
Gdy rozpoznawanie zakończy ładowanie Grammar obiektu, zgłasza LoadGrammarCompleted zdarzenie. Rozpoznawanie zgłasza wyjątek, jeśli Grammar obiekt jest już załadowany, jest ładowany asynchronicznie lub nie może załadować do dowolnego rozpoznawania. Nie można załadować tego samego Grammar obiektu do wielu wystąpień programu SpeechRecognitionEngine. Zamiast tego utwórz nowy Grammar obiekt dla każdego SpeechRecognitionEngine wystąpienia.
Jeśli rozpoznawanie jest uruchomione, aplikacje muszą użyć RequestRecognizerUpdate do wstrzymania aparatu rozpoznawania mowy przed załadowaniem, zwalnianiem, włączaniem lub wyłączaniem gramatyki.
Podczas ładowania gramatyki jest ona domyślnie włączona. Aby wyłączyć załadowaną gramatykę, użyj Enabled właściwości .
Aby załadować gramatykę rozpoznawania mowy synchronicznie, użyj LoadGrammar metody .
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez LoadGrammar(Grammar)usługę .