SpeechRecognitionEngine.RecognizeAsyncCancel Method
Terminates a running instance of a recognition engine without waiting for the current recognition operation to complete.
Assembly: System.Speech (in System.Speech.dll)
When RecognizeAsyncCancel is called, the current asynchrous recognition operation is terminated immediately. All work will be lost and no RecognizeComplete() event will be generated.
RecognizeAsyncCancel can be called an asynchronous operation is on going. The operation could have been initialized by calling RecognizeAsync() or [M:System.Speech.Recognition.SpeechRecognitionEngine.RecognizeAsync(System.Sp][eech.Recognition.RecognizeMode)] with either mode
In the following example show the implementation of a start/stop button for a application with a graphical user interface using SpeechRecognitionEngine. Depending on the state of the application, when the button is clicked either RecognizeAsyncCancel or RecognizeAsyncStop is called with the stop state is selected by the user.
private void _startRecogButton_Click(object sender, EventArgs eventArgs) {
if (_startRecogButton.Text == "Start Speech Recognition") { //Toggle Speech Recogniztion on
_startRecogButton.Text = "Stop Speech Recognition";
if (_useMultiple) {
_recognitionEngine.RecognizeAsync(RecognizeMode.Multiple);
} else {
_recognitionEngine.RecognizeAsync(RecognizeMode.Single);
}
} else { //Toggle Speech Recognition off
_startRecogButton.Text = "Start Speech Recognition";
if (_friendlyStop) {
_recognitionEngine.RecognizeAsyncStop(); //Stop after current phrase is finished.
} else {
_recognitionEngine.RecognizeAsyncCancel(); //Stop before current phrase is finished.
}
}
}
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
