PromptBuilder.AppendTextWithAlias Method

Appends text to the PromptBuilder object and specifies the alias text to be spoken in place of the appended text.

Namespace:  Microsoft.Speech.Synthesis
Assembly:  Microsoft.Speech (in Microsoft.Speech.dll)

public void AppendTextWithAlias(
	string textToSpeak,
	string substitute


Type: System.String
A string containing the text representation.
Type: System.String
A string containing the text to be spoken.

This allows a document to contain both a spoken and a written form for a prompt. For example, the written form could be an acronym, such as SAPI, and the spoken form could be the expanded text for the acronym, in this case Speech Application Programming Interface.

The following example appends a text string ("Speech Synthesis Markup Language") and its alias ("SSML") to a PromptBuilder object. The synthesizer will pronounce "S S M L".

PromptBuilder alias = new PromptBuilder();
alias.AppendTextWithAlias("Speech Synthesis Markup Language","SSML");