Windows apps
Collapse the table of content
Expand the table of content
Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

SpeechRecognitionEngine::LoadGrammarAsync Method (Grammar^)

.NET Framework (current version)
 

Asynchronously loads a speech recognition grammar.

Namespace:   System.Speech.Recognition
Assembly:  System.Speech (in System.Speech.dll)

C#
C++
F#
VB
Copy 
public:
void LoadGrammarAsync(
	Grammar^ grammar
)

Parameters

grammar
Type: System.Speech.Recognition::Grammar^

The speech recognition grammar to load.

Exception Condition
ArgumentNullException

Grammar is null.

InvalidOperationException

Grammar is not in a valid state.

OperationCanceledException

The asynchronous operation was canceled.

When the recognizer completes loading a Grammar object, it raises a LoadGrammarCompleted event. The recognizer throws an exception if the Grammar object is already loaded, is being asynchronously loaded, or has failed to load into any recognizer. You cannot load the same Grammar object into multiple instances of SpeechRecognitionEngine. Instead, create a new Grammar object for each SpeechRecognitionEngine instance.

If the recognizer is running, applications must use RequestRecognizerUpdate to pause the speech recognition engine before loading, unloading, enabling, or disabling a grammar.

When you load a grammar, it is enabled by default. To disable a loaded grammar, use the Enabled property.

To load a speech recognition grammar synchronously, use the LoadGrammar method.

.NET Framework
Available since 3.0
Return to top
Show:
© 2017 Microsoft