Прочитать на английском

Поделиться через


Console.Beep Метод

Определение

Воспроизводит звуковой сигнал через динамик консоли.

Перегрузки

Beep()

Воспроизводит звуковой сигнал через динамик консоли.

Beep(Int32, Int32)

Воспроизводит звуковой сигнал заданной частоты и длительности через динамик консоли.

Beep()

Исходный код:
Console.cs
Исходный код:
Console.cs
Исходный код:
Console.cs

Воспроизводит звуковой сигнал через динамик консоли.

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();
C#
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static void Beep();
C#
public static void Beep();
Атрибуты

Исключения

Этот метод выполнен на сервере, например SQL Server, который не разрешает доступ к интерфейсу пользователя.

Примеры

В следующем примере демонстрируется Beep метод. В этом примере в качестве аргумента командной строки принимается число от 1 до 9 и воспроизводится звуковой сигнал.

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.

*/

Комментарии

По умолчанию звуковой сигнал воспроизводится с частотой 800 гц в течение 200 миллисекунд.

Beep заключает в оболочку вызов функции Windows Beep. Создает ли Beep звук в версиях Windows до Windows 7, зависит от наличия программируемой микросхемы таймера с интервалом 8254. Начиная с Windows 7, он зависит от звукового устройства по умолчанию.

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

Beep(Int32, Int32)

Исходный код:
Console.cs
Исходный код:
Console.cs
Исходный код:
Console.cs

Воспроизводит звуковой сигнал заданной частоты и длительности через динамик консоли.

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

Параметры

frequency
Int32

Частота сигнала в диапазоне от 37 до 32767 Гц.

duration
Int32

Длительность сигнала в миллисекундах.

Атрибуты

Исключения

frequency меньше 37 или больше 32767 Гц.

-или-

duration меньше или равно нулю.

Этот метод выполнен на сервере, например SQL Server, который не разрешает доступ к консоли.

Текущая операционная система не является системой Windows.

Примеры

В этом примере демонстрируется Beep метод воспроизведения первых нескольких нот песни через динамик консоли.

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.
*/

Комментарии

Beep заключает в оболочку вызов функции Windows Beep. Создает ли Beep звук в версиях Windows до Windows 7, зависит от наличия программируемой микросхемы таймера с интервалом 8254. Начиная с Windows 7, он зависит от звукового устройства по умолчанию.

Применяется к

.NET 10 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1