SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Carrega de forma assíncrona uma gramática de reconhecimento de fala.
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 fala a ser carregada.
Exceções
Grammar é null.
Grammar não está em um estado válido.
A operação assíncrona foi cancelada.
Comentários
Quando o reconhecedor conclui o carregamento de um Grammar objeto, ele gera um LoadGrammarCompleted evento. O reconhecedor gera uma exceção se o Grammar objeto já estiver carregado, estiver sendo carregado de forma assíncrona ou não tiver sido carregado em qualquer reconhecedor. Não é possível carregar o mesmo Grammar objeto em várias instâncias de SpeechRecognitionEngine. Em vez disso, crie um novo Grammar objeto para cada SpeechRecognitionEngine instância.
Se o reconhecedor estiver em execução, os aplicativos deverão usar RequestRecognizerUpdate para pausar o mecanismo de reconhecimento de fala antes de carregar, descarregar, habilitar ou desabilitar uma gramática.
Quando você carrega uma gramática, ela é habilitada por padrão. Para desabilitar uma gramática carregada, use a Enabled propriedade.
Para carregar uma gramática de reconhecimento de fala de forma síncrona, use o LoadGrammar método.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por LoadGrammar(Grammar).
