SoundEffect Class

Provides a loaded sound resource. You can play multiple instances of the SoundEffect by calling Play.

Inheritance Hierarchy


Namespace:  Microsoft.Xna.Framework.Audio
Assembly:  Microsoft.Xna.Framework (in Microsoft.Xna.Framework.dll)


Public NotInheritable Class SoundEffect
public sealed class SoundEffect

The SoundEffect type exposes the following members.


  Name Description
Public method SoundEffect(array<Byte[], Int32, AudioChannels) Initializes a new instance of SoundEffect based on an audio buffer, sample rate, and number of audio channels.
Public method SoundEffect(array<Byte[], Int32, Int32, Int32, AudioChannels, Int32, Int32) Initializes a new instance of SoundEffect with specified parameters such as audio sample rate, channels, looping criteria, and a buffer to hold the audio.



  Name Description
Public property Duration Gets the length of time of the SoundEffect.
Public property IsDisposed Gets a value that indicates whether the object is disposed.
Public propertyStatic member MasterVolume Gets or sets the master volume that affects all SoundEffectInstance sounds.



  Name Description
Public method CreateInstance Creates a new SoundEffectInstance for this SoundEffect.
Public method Dispose Releases the resources used by the SoundEffect.
Public methodStatic member FromStream Creates a SoundEffect object based on the specified data stream.
Public methodStatic member GetSampleDuration Returns the sample duration based on the specified sample size and sample rate.
Public methodStatic member GetSampleSizeInBytes Returns the size of the audio sample based on duration, sample rate, and audio channels.
Public method Play() Plays a sound.
Public method Play(Single, Single, Single) Plays a sound based on specified volume, pitch, and panning.


Version Information


Supported in: 5


For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.