SpeechSynthesizer.SelectVoiceByHints Method

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Selects a voice with specific characteristics.

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

NameDescription
System_CAPS_pubmethodSelectVoiceByHints(VoiceGender)

Selects a voice with a specific gender.

System_CAPS_pubmethodSelectVoiceByHints(VoiceGender, VoiceAge)

Selects a voice with a specific gender and age.

System_CAPS_pubmethodSelectVoiceByHints(VoiceGender, VoiceAge, Int32)

Selects a voice with a specific gender and age, based on the position in which the voices are ordered.

System_CAPS_pubmethodSelectVoiceByHints(VoiceGender, VoiceAge, Int32, CultureInfo)

Selects a voice with a specific gender, age, and locale, based on the position in which the voices are ordered.

Use the GetInstalledVoices method and VoiceInfo class to obtain the names of installed text-to-speech (TTS) voices that you can select. The SpeechSynthesizer object selects the first installed voice that matches the specified characteristics.

When an application calls GetInstalledVoices, the method verifies that each of the voices it finds in the registry meets certain minimum criteria. For any voice that fails verification, GetInstalledVoices sets its Enabled property to False. An application cannot select a voice whose Enabled property is False. Typically, applications will not set a voice’s Enabled property.

To select a voice by name, use the SelectVoice method

Return to top
Show: