Console.Beep Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Console.dll

Lit le son d'un signal sonore via le haut-parleur de la console.

Surcharges

Beep()	Lit le son d'un signal sonore via le haut-parleur de la console.
Beep(Int32, Int32)	Lit le son d'un signal sonore à la fréquence et pendant la durée spécifiées, via le haut-parleur de la console.

Beep()

Source:

Console.cs

Lit le son d'un signal sonore via le haut-parleur de la 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();

Attributs

UnsupportedOSPlatformAttribute

Exceptions

HostProtectionException

Cette méthode a été exécutée sur un serveur, tel que SQL Server, qui n’autorise pas l’accès à l’interface utilisateur.

Exemples

L’exemple suivant illustre la Beep méthode. L’exemple accepte un nombre compris entre 1 et 9 comme argument de ligne de commande et lit le bip ce nombre de fois.

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.

*/

Remarques

Par défaut, le bip est lu à une fréquence de 800 hertz pendant une durée de 200 millisecondes.

Beep encapsule un appel à la fonction Beep Windows. La Beep production d’un son sur les versions de Windows antérieures à Windows 7 dépend de la présence d’une puce de minuteur d’intervalle programmable 8254. À compter de Windows 7, cela dépend du périphérique audio par défaut.

Beep(Int32, Int32)

Source:

Console.cs

Lit le son d'un signal sonore à la fréquence et pendant la durée spécifiées, via le haut-parleur de la console.

C#

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

Paramètres

frequency

Int32

Fréquence du signal sonore, comprise entre 37 et 32 767 hertz.

duration

Int32

Durée du signal sonore mesurée en millisecondes.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentOutOfRangeException

frequency est inférieur à 37 ou supérieur à 32 767 hertz.

- ou -

duration est inférieur ou égal à zéro.

HostProtectionException

Cette méthode a été exécutée sur un serveur, tel que SQL Server, qui n’autorise pas l’accès à la console.

PlatformNotSupportedException

Le système d’exploitation actuel n’est pas Windows.

Exemples

Cet exemple illustre la Beep méthode en lisant les premières notes d’une chanson via le haut-parleur de la 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.
*/

Remarques

Beep encapsule un appel à la fonction Beep Windows. La Beep production d’un son sur les versions de Windows antérieures à Windows 7 dépend de la présence d’une puce de minuteur d’intervalle programmable 8254. À compter de Windows 7, cela dépend du périphérique audio par défaut.