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 de manière asynchrone une grammaire de reconnaissance vocale.
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
Grammaire de reconnaissance vocale à charger.
Exceptions
Grammar a la valeur null.
Grammar n’est pas dans un état valide.
L’opération 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é, est chargé de manière asynchrone ou n’a pas pu être chargé dans un 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 le chargement, le déchargement, l’activation ou la désactivation d’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 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 est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par LoadGrammar(Grammar).
