Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

PromptBuilder.AppendAudio Method (Uri)

Appends the audio file at the specified URI to the PromptBuilder.

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


Public Sub AppendAudio ( _
    audioFile As Uri _
Dim instance As PromptBuilder
Dim audioFile As Uri

public void AppendAudio(
    Uri audioFile


  • audioFile
    Type: System.Uri
    URI for the audio file.


The audio file can be in WMA format provided that both of the following conditions are met.

  • The WMA codec is available.

  • The target operating system has the appropriate Windows features installed or enabled.

    • A computer running Microsoft Windows Server 2003 x64 Editions must have Windows Media Format 9.5 Software Development Kit (SDK) x64 Edition installed.

    • A computer running Microsoft Windows Server 2008 or Windows Server 2008 R2 must have the Desktop Experience feature installed, as described in the following procedure.

    • Windows Vista and Windows 7 already have the Desktop Experience feature enabled automatically.

To install the Desktop Experience feature (Windows Server 2008, Windows Server 2008 R2)

  1. On the Start menu, click Server Management.

  2. In the Server Management dialog box, in the Features Summary pane, click Add Features.

  3. In the Select Features dialog box, select the Desktop Experience check box, and then click Install.


The following example initializes a new instance to the PromptBuilder class and then adds text, followed by an audio file, to it.

using Microsoft.Speech.PromptBuilder;

public void SimpleConcatenation()

    // Concatenate a prompt fragment from a .wav file
    PromptBuilder builder = new PromptBuilder ();
    builder.AppendText("How are you today?");
    builder.AppendAudio(new Uri (""));

The following markup shows the equivalent SSML.

<speak xmlns=""
       xmlns:ms="" xml:lang="en">
  How are you today?
  <audio src="" />

See Also


PromptBuilder Class

PromptBuilder Members

AppendAudio Overload

Microsoft.Speech.Synthesis Namespace