SpeechRecognitionEngine.LoadGrammarAsync(Grammar) Méthode

Définition

Espace de noms:

System.Speech.Recognition

Assembly:

System.Speech.dll

Paquet:

System.Speech v9.0.0-preview.3.24172.9

Source:

SpeechRecognitionEngine.cs

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 -> unit

Public Sub LoadGrammarAsync (grammar As Grammar)

Paramètres

grammar

Grammar

Syntaxe de reconnaissance vocale à charger.

Exceptions

ArgumentNullException

Grammar a la valeur null.

InvalidOperationException

Grammar n'est pas un état valide.

OperationCanceledException

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).

Voir aussi

• LoadGrammarCompleted
• RecognizerUpdateReached
• LoadGrammar(Grammar)
• UnloadAllGrammars()
• UnloadGrammar(Grammar)