This documentation is archived and is not being maintained.

SpeechSynthesizer.SelectVoice Method

Selects a specific voice by name.

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

public void SelectVoice(
	string name


Type: System.String
The name of the voice to select.

Use the GetInstalledVoices method and VoiceInfo class to obtain the names of installed text-to-speech (TTS) voices that you can select. To select a voice, pass the entire contents of the Name property as the argument for the SelectVoice(String) method. The SpeechSynthesizer object selects the first installed voice that contains name in the voice's VoiceInfo.Name property. The SpeechSynthesizer performs a case-sensitive, substring comparison to determine if the voice matches the name.

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 gender, age, or locale, use one of the SelectVoiceByHints methods.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.