SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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).
