SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega assíncronamente uma gramática de reconhecimento de voz.
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)Parâmetros
- grammar
- Grammar
A gramática de reconhecimento de voz para carregar.
Exceções
Grammar é null.
Grammar não está num estado válido.
A operação assíncrona foi cancelada.
Observações
Quando o recognizer completa o carregamento de um Grammar objeto, gera um LoadGrammarCompleted evento. O recognizer lança uma exceção se o Grammar objeto já estiver carregado, estiver a ser carregado assíncronamente ou tiver falhado em carregar em qualquer recognizer. Não podes carregar o mesmo Grammar objeto em múltiplas instâncias de SpeechRecognitionEngine. Em vez disso, crie um novo Grammar objeto para cada SpeechRecognitionEngine instância.
Se o reconhecedor estiver a funcionar, as aplicações devem usar RequestRecognizerUpdate para pausar o motor de reconhecimento de fala antes de carregar, descarregar, ativar ou desativar uma gramática.
Quando carregas uma gramática, ela está ativada por defeito. Para desativar uma gramática carregada, use a Enabled propriedade.
Para carregar uma gramática de reconhecimento de voz de forma síncrona, use o LoadGrammar método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por LoadGrammar(Grammar).