Beep Method
Collapse the table of content
Expand the table of content

Console::Beep Method ()

 

Plays the sound of a beep through the console speaker.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
[HostProtectionAttribute(SecurityAction::LinkDemand, UI = true)]
static void Beep()

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.

System_CAPS_noteNote

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.

*/

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft