PromptBuilder.AppendText Metodo

Definizione

Aggiunge testo all'oggetto PromptBuilder.Appends text to the PromptBuilder object.

Overload

AppendText(String)

Specifica il testo da aggiungere all'oggetto PromptBuilder.Specifies text to append to the PromptBuilder object.

AppendText(String, PromptEmphasis)

Aggiunge il testo all'oggetto PromptBuilder e specifica il grado di enfasi per il testo.Appends text to the PromptBuilder object and specifies the degree of emphasis for the text.

AppendText(String, PromptRate)

Aggiunge il testo all'oggetto PromptBuilder e specifica la velocità di pronuncia per il testo.Appends text to the PromptBuilder object and specifies the speaking rate for the text.

AppendText(String, PromptVolume)

Aggiunge il testo all'oggetto PromptBuilder e specifica il volume della pronuncia del testo.Appends text to the PromptBuilder object and specifies the volume to speak the text.

AppendText(String)

Specifica il testo da aggiungere all'oggetto PromptBuilder.Specifies text to append to the PromptBuilder object.

public:
 void AppendText(System::String ^ textToSpeak);
public void AppendText (string textToSpeak);
member this.AppendText : string -> unit
Public Sub AppendText (textToSpeak As String)

Parametri

textToSpeak
String

Stringa contenente il testo da usare come input vocale.A string containing the text to be spoken.

Esempio

Nell'esempio seguente viene creato un oggetto PromptBuilder e viene aggiunta una stringa di testo utilizzando il metodo AppendText.The example that follows creates a PromptBuilder object and appends a text string using the AppendText method.

using System;  
using System.Speech.Synthesis;  
  
namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
  
      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  
  
        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  
  
        // Create a PromptBuilder object and append a text string.  
        PromptBuilder speakText = new PromptBuilder();  
        speakText.AppendText("Say the name of the song you want to hear");  
  
        // Speak the contents of the prompt.  
        synth.Speak(speakText);  
      }  
  
      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Commenti

Per aggiungere testo formattato come SSML Markup Language, utilizzare AppendSsmlMarkup.To append text that is formatted as SSML markup language, use AppendSsmlMarkup.

AppendText(String, PromptEmphasis)

Aggiunge il testo all'oggetto PromptBuilder e specifica il grado di enfasi per il testo.Appends text to the PromptBuilder object and specifies the degree of emphasis for the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptEmphasis emphasis);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptEmphasis emphasis);
member this.AppendText : string * System.Speech.Synthesis.PromptEmphasis -> unit
Public Sub AppendText (textToSpeak As String, emphasis As PromptEmphasis)

Parametri

textToSpeak
String

Stringa contenente il testo da usare come input vocale.A string containing the text to be spoken.

emphasis
PromptEmphasis

Il valore per l'enfasi o l'accento da applicare al testo.The value for the emphasis or stress to apply to the text.

Commenti

I motori di sintesi vocale in Windows non supportano il parametro enfasi in questo momento.The speech synthesis engines in Windows do not support the emphasis parameter at this time. L'impostazione dei valori per il parametro enfasi non produrrà alcuna modifica acustica nell'output vocale sintetizzato.Setting values for the emphasis parameter will produce no audible change in the synthesized speech output.

AppendText(String, PromptRate)

Aggiunge il testo all'oggetto PromptBuilder e specifica la velocità di pronuncia per il testo.Appends text to the PromptBuilder object and specifies the speaking rate for the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptRate rate);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptRate rate);
member this.AppendText : string * System.Speech.Synthesis.PromptRate -> unit
Public Sub AppendText (textToSpeak As String, rate As PromptRate)

Parametri

textToSpeak
String

Stringa contenente il testo da usare come input vocale.A string containing the text to be spoken.

rate
PromptRate

Il valore per la velocità di pronuncia da applicare al testo.The value for the speaking rate to apply to the text.

Esempio

Nell'esempio seguente viene creato un oggetto PromptBuilder e vengono accodate le stringhe di testo.The following example creates a PromptBuilder object and appends text strings. Nell'esempio viene usato il metodo AppendText per specificare una velocità di pronuncia lenta per la stringa da aggiungere, che enumera il contenuto di un ordine.The example uses the AppendText method to specify a slow speaking rate for the string being added, which enumerates the contents of an order.

using System;  
using System.Speech.Synthesis;  
  
namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
  
      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  
  
        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  
  
        // Create a PromptBuilder object and add content.  
        PromptBuilder speakRate = new PromptBuilder();  
        speakRate.AppendText("Your order for");  
        speakRate.AppendText("one kitchen sink and one faucet", PromptRate.Slow);  
        speakRate.AppendText("has been confirmed.");  
  
        // Speak the contents of the SSML prompt.  
        synth.Speak(speakRate);  
      }  
  
      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  
  

AppendText(String, PromptVolume)

Aggiunge il testo all'oggetto PromptBuilder e specifica il volume della pronuncia del testo.Appends text to the PromptBuilder object and specifies the volume to speak the text.

public:
 void AppendText(System::String ^ textToSpeak, System::Speech::Synthesis::PromptVolume volume);
public void AppendText (string textToSpeak, System.Speech.Synthesis.PromptVolume volume);
member this.AppendText : string * System.Speech.Synthesis.PromptVolume -> unit
Public Sub AppendText (textToSpeak As String, volume As PromptVolume)

Parametri

textToSpeak
String

Stringa contenente il testo da usare come input vocale.A string containing the text to be spoken.

volume
PromptVolume

Il valore per il volume della pronuncia da applicare al testo.The value for the speaking volume (loudness) to apply to the text.

Esempio

Nell'esempio seguente viene usato il metodo AppendText per specificare le impostazioni del volume che il SpeechSynthesizer deve applicare all'output vocale.The following example uses the AppendText method to specify volume settings that the SpeechSynthesizer should apply to speech output.

using System;  
using System.Speech.Synthesis;  
  
namespace SampleSynthesis  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
  
      // Initialize a new instance of the SpeechSynthesizer.  
      using (SpeechSynthesizer synth = new SpeechSynthesizer())  
      {  
  
        // Configure the audio output.   
        synth.SetOutputToDefaultAudioDevice();  
  
        // Build a prompt that applies different volume settings.  
        PromptBuilder builder = new PromptBuilder();  
        builder.AppendText("This is the default speaking volume.", PromptVolume.Default);  
        builder.AppendBreak();  
        builder.AppendText("This is the extra loud speaking volume.", PromptVolume.ExtraLoud);  
        builder.AppendBreak();  
        builder.AppendText("This is the medium speaking volume.", PromptVolume.Medium);  
  
        // Speak the prompt.  
        synth.Speak(builder);  
      }  
  
      Console.WriteLine();  
      Console.WriteLine("Press any key to exit...");  
      Console.ReadKey();  
    }  
  }  
}  

Commenti

L'impostazione Default per PromptVolume è il volume intero, che corrisponde a ExtraLoud.The Default setting for PromptVolume is full volume, which is the same as ExtraLoud. Le altre impostazioni riducono il volume dell'output vocale rispetto al volume intero.The other settings decrease the volume of speech output relative to full volume.

Si applica a