SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет асинхронную загрузку грамматики распознавания речи.
public:
void LoadGrammarAsync(System::Speech::Recognition::Grammar ^ grammar);public void LoadGrammarAsync (System.Speech.Recognition.Grammar grammar);member this.LoadGrammarAsync : System.Speech.Recognition.Grammar -> unitPublic Sub LoadGrammarAsync (grammar As Grammar)Параметры
- grammar
- Grammar
Грамматика распознавания речи для загрузки.
Исключения
Grammar имеет значение null.
Состояние Grammar недопустимо.
Асинхронная операция была отменена.
Комментарии
Когда распознаватель завершает загрузку Grammar объекта, он вызывает LoadGrammarCompleted событие . Распознаватель создает исключение, если Grammar объект уже загружен, загружается асинхронно или не удалось загрузить в какой-либо распознаватель. Нельзя загрузить один и тот же Grammar объект в несколько экземпляров SpeechRecognitionEngine. Вместо этого создайте новый Grammar объект для каждого экземпляра SpeechRecognitionEngine .
Если распознаватель запущен, приложения должны использовать для RequestRecognizerUpdate приостановки обработчика распознавания речи перед загрузкой, выгрузкой, включением или отключением грамматики.
При загрузке грамматики она включена по умолчанию. Чтобы отключить загруженную грамматику Enabled , используйте свойство .
Чтобы загрузить грамматику распознавания речи синхронно, используйте LoadGrammar метод .
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые LoadGrammar(Grammar).
