Partilhar via


SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método

Definição

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).

Aplica-se a

Confira também