Burner Class

ZylBurner.NET is a CD/DVD burner .NET component. It is based on NeroCmd utility, so it needs Nero Burning ROM to be installed. This component is very easy to use, it's ideal for developers for quick CD/DVD writing purposes from .NET applications. The component works in two modes: synchronous mode and asynchronous mode. In synchronous mode the operational functions (Burn, Erase, BurnImage, Eject) always wait for the end of the current operation and return a value which indicates if the operation was successful or not. In synchronous mode the return value of the operational functions is always 0, and the functions don't wait for the end of the current operation. You can use it to burn data CDs/DVDs, audio CDs, video CDs and super video CDs.

Inheritance Hierarchy

SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      ZylSoft.MediaBurner

Namespace: ZylSoft.Media
Assembly: ZylBurner (in ZylBurner.dll) Version: 1.14.8015.18472

Syntax

C++

ASP.NET

Copy

public class Burner : Component

Public Class Burner
	Inherits Component

Dim instance As Burner

public ref class Burner : public Component

type Burner =  
    class
        inherit Component
    end

The Burner type exposes the following members.

Constructors

	Name	Description
	Burner	Constructor.
	Burner(IContainer)	Constructor.

Top

Properties

	Name	Description
	Artist	Artist of the CD/DVD.
	Bluray	Specifies the media type. If true then is blue-ray.
	CanRaiseEvents	Gets a value indicating whether the component can raise an event. (Inherited from Component.)
	CloseSession	Close current session.
	Container	Gets the IContainer that contains the Component. (Inherited from Component.)
	ContinueSession	If the value of this property is higher than -1, then the specified session will be imported and the disk will be continued. The value 0 represents the first session.
	DesignMode	Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
	DetectNonEmptyDisk	Detect non empty CD/DVD.
	DisableEject	Disable eject after burn.
	DiskType	Specifies the type of the disk, which can be Data, Audio, Video or Super Video.
	Dvd	Specifies the media type. If true then is DVD, else is CD.
	Events	Gets the list of event handlers that are attached to this Component. (Inherited from Component.)
	Files	List of files or folders to burn.
	ForceEraseDisk	Force erase disk.
	HideNeroCmd	If this property is true then NeroCmd window is hidden.
	ShowMessages	Enables / disables messages
	Site	Gets or sets the ISite of the Component. (Inherited from Component.)
	Speed	Burn speed.
	SpeedTest	Speed test before burn.
	Synchronous	If this property is true then the component works in synchronous mode. In synchronous mode the operational functions (Burn, Erase, BurnImage, Eject) always wait for the end of the current operation and return a value which indicates if the operation was successful or not. If this property is true then the return value of the operational functions is always 0, and the functions don't wait for the end of the current operation.
	Tao	Tao mode enabled.
	Title	Title of the CD/DVD.
	UnderrunProtection	Under-run protection activated.
	UnlockKey	Unlock key.
	Verify	Verify CD/DVD.
	VolumeLabel	Volume label of the CD/DVD.

Top

Methods

	Name	Description
	Burn	Burns CD / DVD using the specified burner drive. The type of the disk is specified in the DiskType property.
	BurnAudio	Burns audio CD using the specified burner drive.
	BurnData	Burns data CD/DVD using the specified burner drive.
	BurnDvdVideo	Burns video DVD using the specified burner drive.
	BurnImage	Burns CD from image file using the specified burner drive.
	BurnSuperVideo	Burns super video CD using the specified burner drive.
	BurnVideo	Burns video CD using the specified burner drive.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	Dispose	Releases all resources used by the Component. (Inherited from Component.)
	Dispose(Boolean)	Clean up any resources being used. (Overrides ComponentDispose(Boolean).)
	Eject	Ejects the specified burner drive.
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Erase	Erases rewritable using the specified burner drive.
	Finalize	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetNeroCmdLocation	Gets the current value of NeroCmd.exe's location used by the component.
	GetService	Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	OnError	Raises the Error event.
	OnSuccess	Raises the Success event.
	SetNeroCmdLocation	Sets the location of NeroCmd.exe (including the name of the file).
	ToString	Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)

Top

Events

	Name	Description
	Disposed	Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
	Error	Occurs when error occurred during the burning process.
	Success	Occurs when data successfully burnt.

Top

Reference

ZylSoft.Media Namespace