Console.Beep メソッド

定義

名前空間:

System

アセンブリ:

netstandard.dll, System.Console.dll

コンソールのスピーカーからビープ音を出します。

オーバーロード

Beep()	コンソールのスピーカーからビープ音を出します。
Beep(Int32, Int32)	周波数と時間を指定して、コンソールのスピーカーからビープ音を出します。

Beep()

ソース:

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();

属性

UnsupportedOSPlatformAttribute

例外

HostProtectionException

このメソッドは、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.

*/

注釈

既定では、ビープ音は 200 ミリ秒の間、800 ヘルツの頻度で再生されます。

Beep は、Windows Beep 関数の呼び出しをラップします。 Windows 7 より前のバージョンの Windows でサウンドを生成するかどうか Beep は、8254 プログラム可能な間隔タイマー チップの存在によって異なります。 Windows 7 以降では、既定のサウンド デバイスによって異なります。

Beep(Int32, Int32)

ソース:

Console.cs

周波数と時間を指定して、コンソールのスピーカーからビープ音を出します。

C#

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

パラメーター

frequency

Int32

ビープ音の周波数。37 Hz から 32767 Hz の範囲で指定できます。

duration

Int32

ビープ音の再生時間。ミリ秒単位で指定します。

属性

SupportedOSPlatformAttribute

例外

ArgumentOutOfRangeException

frequency は 37 ヘルツ未満または 32767 ヘルツを超えます。

または

duration が 0 以下です。

HostProtectionException

このメソッドは、SQL Server などのコンソールへのアクセスを許可しないサーバーで実行されました。

PlatformNotSupportedException

現在のオペレーティング システムは 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 関数の呼び出しをラップします。 Windows 7 より前のバージョンの Windows でサウンドを生成するかどうか Beep は、8254 プログラム可能な間隔タイマー チップの存在によって異なります。 Windows 7 以降では、既定のサウンド デバイスによって異なります。