SpeechRecognitionEngine.LoadGrammarAsync(Grammar) 方法

定義

命名空間:

System.Speech.Recognition

組件:

System.Speech.dll

套件:

System.Speech v9.0.0-preview.3.24172.9

來源:

SpeechRecognitionEngine.cs

以非同步方式載入語音辨識文法。

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

Grammar

要載入的語音辨識文法。

例外狀況

ArgumentNullException

Grammar 為 null。

InvalidOperationException

Grammar 不是有效狀態。

OperationCanceledException

非同步作業已取消。

備註

辨識器完成載入 Grammar 物件時，會引發 LoadGrammarCompleted 事件。 如果 Grammar 物件已載入、正在非同步載入或無法載入至任何辨識器，辨識器就會擲回例外狀況。 您無法將相同的 Grammar 物件載入多個 實例 SpeechRecognitionEngine 。 相反地，請為每個 SpeechRecognitionEngine 實例建立新的 Grammar 物件。

如果辨識器正在執行，應用程式必須先使用 RequestRecognizerUpdate 暫停語音辨識引擎，再載入、卸載、啟用或停用文法。

當您載入文法時，預設會啟用它。 若要停用載入的文法，請使用 Enabled 屬性。

若要同步載入語音辨識文法，請使用 LoadGrammar 方法。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 LoadGrammar(Grammar) 擲回的例外狀況。

另請參閱

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