SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Charge une syntaxe de reconnaissance vocale de façon asynchrone.
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)Paramètres
- grammar
- Grammar
Syntaxe de reconnaissance vocale à charger.
Exceptions
Grammar a la valeur null.
Grammar n'est pas un état valide.
L'opération d'annulation asynchrone a été annulée.
Remarques
Lorsque le module de reconnaissance termine le chargement d’un Grammar objet, il déclenche un LoadGrammarCompleted événement. Le module de reconnaissance lève une exception si l’objet Grammar est déjà chargé, qu’il est en cours de chargement asynchrone ou qu’il n’a pas pu être chargé dans n’importe quel module de reconnaissance. Vous ne pouvez pas charger le même Grammar objet dans plusieurs instances de SpeechRecognitionEngine. Au lieu de cela, créez un Grammar objet pour chaque SpeechRecognitionEngine instance.
Si le module de reconnaissance est en cours d’exécution, les applications doivent utiliser RequestRecognizerUpdate pour suspendre le moteur de reconnaissance vocale avant de charger, de décharger, d’activer ou de désactiver une grammaire.
Lorsque vous chargez une grammaire, elle est activée par défaut. Pour désactiver une grammaire chargée, utilisez la Enabled propriété .
Pour charger une grammaire de reconnaissance vocale de manière synchrone, utilisez la LoadGrammar méthode .
Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par LoadGrammar(Grammar).
