Console.Beep Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Console.dll

Reproduz o som de um aviso sonoro por meio do alto-falante do console.

Sobrecargas

Beep()	Reproduz o som de um aviso sonoro por meio do alto-falante do console.
Beep(Int32, Int32)	Reproduz o som de um aviso sonoro de frequência e duração especificadas por meio do alto-falante do console.

Beep()

Origem:

Console.cs

Reproduz o som de um aviso sonoro por meio do alto-falante do console.

C#

[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static void Beep();

Atributos

UnsupportedOSPlatformAttribute

Exceções

HostProtectionException

Esse método foi executado em um servidor, como o SQL Server, que não permite acesso a uma interface do usuário.

Exemplos

O exemplo a seguir demonstra o Beep método. O exemplo aceita um número de 1 a 9 como um argumento de linha de comando e reproduz o bipe esse número de vezes.

C#

// 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)) &&
        ((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.

*/

Comentários

Por padrão, o bipe é reproduzido em uma frequência de 800 hertz por uma duração de 200 milissegundos.

Beep encapsula uma chamada para a função Bipe do Windows. Se Beep produz um som em versões do Windows antes do Windows 7 depende da presença de um chip de temporizador de intervalo programável 8254. A partir do Windows 7, ele depende do dispositivo de som padrão.

Beep(Int32, Int32)

Origem:

Console.cs

Reproduz o som de um aviso sonoro de frequência e duração especificadas por meio do alto-falante do console.

C#

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Beep(int frequency, int duration);

Parâmetros

frequency

Int32

A frequência do aviso sonoro, variando de 37 a 32.767 hertz.

duration

Int32

A duração do aviso sonoro medida em milissegundos.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

frequency é menor que 37 ou maior que 32.767.

- ou -

duration é menor que ou igual a zero.

HostProtectionException

Esse método foi executado em um servidor, como SQL Server, que não permite acesso ao console.

PlatformNotSupportedException

O sistema operacional atual não é o Windows.

Exemplos

Este exemplo demonstra o Beep método tocando as primeiras notas de uma música por meio do alto-falante do console.

C#

// This example demonstrates the Console.Beep(Int32, Int32) method
using System;
using System.Threading;

class Sample
{
    public static void Main()
    {
// Declare the first few notes of the song, "Mary Had A Little Lamb".
    Note[] Mary =
        {
        new Note(Tone.B, Duration.QUARTER),
        new Note(Tone.A, Duration.QUARTER),
        new Note(Tone.GbelowC, Duration.QUARTER),
        new Note(Tone.A, Duration.QUARTER),
        new Note(Tone.B, Duration.QUARTER),
        new Note(Tone.B, Duration.QUARTER),
        new Note(Tone.B, Duration.HALF),
        new Note(Tone.A, Duration.QUARTER),
        new Note(Tone.A, Duration.QUARTER),
        new Note(Tone.A, Duration.HALF),
        new Note(Tone.B, Duration.QUARTER),
        new Note(Tone.D, Duration.QUARTER),
        new Note(Tone.D, Duration.HALF)
        };
// Play the song
    Play(Mary);
    }

// Play the notes in a song.
    protected static void Play(Note[] tune)
    {
    foreach (Note n in tune)
        {
        if (n.NoteTone == Tone.REST)
            Thread.Sleep((int)n.NoteDuration);
        else
            Console.Beep((int)n.NoteTone, (int)n.NoteDuration);
        }
    }

// Define the frequencies of notes in an octave, as well as
// silence (rest).
    protected enum Tone
    {
    REST   = 0,
    GbelowC = 196,
    A      = 220,
    Asharp = 233,
    B      = 247,
    C      = 262,
    Csharp = 277,
    D      = 294,
    Dsharp = 311,
    E      = 330,
    F      = 349,
    Fsharp = 370,
    G      = 392,
    Gsharp = 415,
    }

// Define the duration of a note in units of milliseconds.
    protected enum Duration
    {
    WHOLE     = 1600,
    HALF      = WHOLE/2,
    QUARTER   = HALF/2,
    EIGHTH    = QUARTER/2,
    SIXTEENTH = EIGHTH/2,
    }

// Define a note as a frequency (tone) and the amount of
// time (duration) the note plays.
    protected struct Note
    {
    Tone     toneVal;
    Duration durVal;

// Define a constructor to create a specific note.
    public Note(Tone frequency, Duration time)
        {
        toneVal = frequency;
        durVal  = time;
        }

// Define properties to return the note's tone and duration.
    public Tone NoteTone { get{ return toneVal; } }
    public Duration NoteDuration { get{ return durVal; } }
    }
}
/*
This example produces the following results:

This example plays the first few notes of "Mary Had A Little Lamb"
through the console speaker.
*/

Comentários

Beep encapsula uma chamada para a função Bipe do Windows. Se Beep produz um som em versões do Windows antes do Windows 7 depende da presença de um chip de temporizador de intervalo programável 8254. A partir do Windows 7, ele depende do dispositivo de som padrão.