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 -> unit
Public 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 objeto válido.
A operação assíncrona foi cancelada.
Comentários
Quando o reconhecedor conclui o carregamento uma Grammar do objeto, ele gera um LoadGrammarCompleted eventos. O reconhecedor gera uma exceção se o Grammar objeto já está carregado, está sendo carregado de forma assíncrona ou falhou ao ser carregado em nenhum reconhecedor. Não é possível carregar o mesmo Grammar objeto em várias instâncias do SpeechRecognitionEngine. Em vez disso, crie um novo Grammar para cada objeto 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).