Compartir a través de


SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método

Definición

De forma asincrónica carga 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

La gramática de reconocimiento de voz para cargar.

Excepciones

Grammar es null.

Grammar no está en un estado válido.

La operación asincrónica se canceló.

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 cualquier 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 sincrónicamente, use el LoadGrammar método .

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

Se aplica a

Consulte también