Console::Beep Method ()
Plays the sound of a beep through the console speaker.
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| HostProtectionException | This method was executed on a server, such as SQL Server, that does not permit access to a user interface. |
By default, the beep plays at a frequency of 800 hertz for a duration of 200 milliseconds.
Note |
|---|
The Beep method is not supported on the 64-bit editions of Windows Vista and Windows XP. |
Beep wraps a call to the Windows Beep function. Whether Beep produces a sound on versions of Windows before Windows 7 depends on the presence of a 8254 programmable interval timer chip. Starting with Windows 7, it depends on the default sound device.
The following example demonstrates the Beep method. The example accepts a number from 1 through 9 as a command line argument, and plays the beep that number of times.
// This example demonstrates the Console.Beep() method. using namespace System; int main() { array<String^>^args = Environment::GetCommandLineArgs(); int x = 0; // if ( (args->Length == 2) && (Int32::TryParse( args[ 1 ], x ) == true) && ((x >= 1) && (x <= 9)) ) { for ( int i = 1; i <= x; i++ ) { Console::WriteLine( "Beep number {0}.", i ); Console::Beep(); } } else Console::WriteLine( "Usage: Enter the number of times (between 1 and 9) to beep." ); } /* This example produces the following results: >beep Usage: Enter the number of times (between 1 and 9) to beep >beep 9 Beep number 1. Beep number 2. Beep number 3. Beep number 4. Beep number 5. Beep number 6. Beep number 7. Beep number 8. Beep number 9. */
Available since 2.0
