SpeechRecognitionEngine.LoadGrammarAsync(Grammar) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

异步加载语音识别语法。

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)

加载语音识别语法。

Grammar 为 null。

Grammar 不在有效状态中。

异步操作已取消。

当识别器完成加载对象时 Grammar ，它将引发事件 LoadGrammarCompleted 。如果 Grammar 对象已加载、正在异步加载或未能加载到任何识别器中，则识别器将引发异常。不能将同一 Grammar 对象加载到的 SpeechRecognitionEngine多个实例中。而是为每个SpeechRecognitionEngine实例创建一个新的 Grammar 对象。

如果识别器正在运行，应用程序必须使用 RequestRecognizerUpdate 在加载、卸载、启用或禁用语法之前暂停语音识别引擎。

加载语法时，默认启用语法。若要禁用加载的语法，请使用 Enabled 属性。

若要同步加载语音识别语法，请使用 LoadGrammar 方法。

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 LoadGrammar(Grammar)异常。