Compartir por


SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método

Definición

Carga asincrónicamente una gramática de reconocimiento 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 -> unit
Public Sub LoadGrammarAsync (grammar As Grammar)

Parámetros

grammar
Grammar

Gramática de reconocimiento de voz que se va a cargar.

Excepciones

Grammar es null.

Grammar no está en un estado válido.

Se canceló la operación asincrónica.

Comentarios

Cuando el reconocedor finaliza la carga de un Grammar objeto, genera un LoadGrammarCompleted evento . El reconocedor produce una excepción si el Grammar objeto ya está cargado, se está cargando de forma asincrónica o no se pudo cargar en ningún reconocedor. No se puede cargar el mismo Grammar objeto en varias instancias de SpeechRecognitionEngine. En su lugar, cree un nuevo Grammar objeto para cada SpeechRecognitionEngine instancia.

Si el reconocedor se está ejecutando, las aplicaciones deben usar RequestRecognizerUpdate para pausar el motor de reconocimiento de voz antes de cargar, descargar, habilitar o deshabilitar una gramática.

Cuando se carga una gramática, se habilita de forma predeterminada. Para deshabilitar una gramática cargada, use la Enabled propiedad .

Para cargar una gramática de reconocimiento de voz de forma sincrónica, use el LoadGrammar método .

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por LoadGrammar(Grammar).

Se aplica a

Consulte también