Console.Beep Method
Plays the sound of a beep through the console speaker.
Namespace: System
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. |
| Note |
|---|
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: UI. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes. |
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 System; class Sample { public static void Main(String[] args) { int x = 0; // if ((args.Length == 1) && (Int32.TryParse(args[0], out 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. */
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
