SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método

Definição

Namespace:

System.Speech.Recognition

Assembly:

System.Speech.dll

Pacote:

System.Speech v9.0.0-preview.3.24172.9

Origem:

SpeechRecognitionEngine.cs

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

ArgumentNullException

Grammar é null.

InvalidOperationException

Grammar não está em um objeto válido.

OperationCanceledException

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

Confira também

• LoadGrammarCompleted
• RecognizerUpdateReached
• LoadGrammar(Grammar)
• UnloadAllGrammars()
• UnloadGrammar(Grammar)