SpeechSynthesizer.SpeakAsyncCancel(Prompt) Method

Definition

Namespace:

System.Speech.Synthesis

Assembly:

System.Speech.dll

Package:

System.Speech v10.0.0-preview.1.25080.5

Source:

SpeechSynthesizer.cs

Cancels the asynchronous synthesis operation for a queued prompt.

C#

public void SpeakAsyncCancel(System.Speech.Synthesis.Prompt prompt);

Parameters

prompt

Prompt

The content for which to cancel a speak operation.

Remarks

You can also use this method to cancel an asynchronous speak operation for the following:

• The contents of a String specified by a SpeechSynthesizer.SpeakAsync method.

• The contents of a PromptBuilder specified by a SpeechSynthesizer.SpeakAsync method.

• The contents of a String containing SSML specified by a SpeakSsmlAsync method.

When you call SpeechSynthesizer.SpeakAsync, SpeechSynthesizer.SpeakAsync, or SpeakSsmlAsync, System.Speech creates a Prompt object and populates it with the contents of the method's parameter, and returns the Prompt object. If you retain a copy of the returned Prompt, you can pass it into SpeakAsyncCancel to cancel speaking content specified in a String or a PromptBuilder object.

Applies to