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 -> unit
Public Sub LoadGrammarAsync (grammar As Grammar)

Параметры

grammar
Grammar

Грамматика распознавания речи для загрузки.

Исключения

Grammar имеет значение null.

Состояние Grammar недопустимо.

Асинхронная операция была отменена.

Комментарии

Когда распознаватель завершает загрузку Grammar объекта, он вызывает LoadGrammarCompleted событие . Распознаватель создает исключение, если Grammar объект уже загружен, загружается асинхронно или не удалось загрузить в какой-либо распознаватель. Нельзя загрузить один и тот же Grammar объект в несколько экземпляров SpeechRecognitionEngine. Вместо этого создайте новый Grammar объект для каждого экземпляра SpeechRecognitionEngine .

Если распознаватель запущен, приложения должны использовать для RequestRecognizerUpdate приостановки обработчика распознавания речи перед загрузкой, выгрузкой, включением или отключением грамматики.

При загрузке грамматики она включена по умолчанию. Чтобы отключить загруженную грамматику Enabled , используйте свойство .

Чтобы загрузить грамматику распознавания речи синхронно, используйте LoadGrammar метод .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые LoadGrammar(Grammar).

Применяется к

См. также раздел