Wo bekomme ich die benötigten Dateien?

Transkript

1 Dieser Artikel stammt aus dem Magazin von C++.de ( Wie kann man mit Nero und C# eine CD/DVD brennen??? Inhaltsverzeichnis 1. Einleitung 2. Was benötigen wir dazu? 3. Wo bekomme ich die benötigten Dateien? 4. Aufteilung des Tutorials 5. Erstellen der zu nutzenden DLL für unser C#-Programm 6. Erstellen eines Programms zum Brennen von Daten auf CD Einleitung Hallo zusammen, in diesem kleinen Tutorial möchte ich euch zeigen, wie man mithilfe der NeroAPI und der Programmiersprache C# eine Anwendung entwickeln kann, mit der sich eigene CDs / DVDs erstellen lassen. Was benötigen wir dazu? Als Erstes benötigen wir einen Texteditor, in dem wir später unseren Quellcode schreiben können. Als Zweites benötigen wir noch eine SDK-Version des Frameworks, mit dem wir später unseren Quellcode zu einer EXE- oder DLL-Datei konvertieren können. Und zum Schluss benötigen wir noch eine installierte Version von dem Brennprogramm Nero! Wo bekomme ich die benötigten Dateien? Eine Demoversion des Brennprogrammes Nero bekommt ihr unter [1]! Die SDK-Version des.net Frameworks könnt ihr euch unter [2] kostenlos herunterladen! Aufteilung des Tutorials Im ersten Teil dieses Tutorials möchte ich euch zeigen, wie wir die benötigte Assemblydatei der NeroCOM erstellen. Diese Assemblydatei benötigen wir ebenfalls im zweiten Teil dieses Tutorials. Im zweiten Teil möchte ich euch zeigen, wie man mithilfe der NeroCOM-Schnittstelle ein kleines Programm erstellt, das ermöglicht, CDs / DVDs zu brennen. 1

2 Erstellen der zu nutzenden DLL für unser C#-Programm Bevor wir mit dem Programmieren anfangen können, müssen wir uns zuerst einmal die COM von Nero in eine funktionsfähige Assembly konvertieren! 1. Wir suchen uns in dem Nero-Verzeichnis die Datei NeroCOM.dll heraus und konvertieren diese mithilfe des "Microsoft (R).NET Framework Type Library to Assembly Converter" (tlbimp.exe) in eine.net-assembly. 2. Dazu geben wir Folgendes in der Eingabeaufforderung ein: "tlbimp.exe NeroCOM.dll". Anschließend sollten wir folgende Rückmeldung des Konverters erhalten: "Type library imported to NEROLib.dll". Dies bedeutet, dass uns das Konvertierungsprogramm eine Assembly namens NEROlib.dll erstellt hat, die wir nun im.net Framework nutzen können. Hinweis: Es wäre zum jetzigen Zeitpunkt zwar schon möglich, mithilfe dieser Assembly eine CD / DVD zu erzeugen, aber im jetzigen Zustand würde keines der von der COM-Schnittstelle zur Verfügung stehenden Events ausgelöst werden. 3. Um genau dies zu erreichen, dass auch die zur Verfügung stehenden Events in unserem Programm genutzt werden können, müssen wir die so eben erzeugte Assembly-Datei noch ein wenig bearbeiten. Um dies durchzuführen, müssen wir die Datei zuerst mit dem Programm "ildasm.exe" in IL-Assemblercode extrahieren. Dazu müssen wir in der Eingabeaufforderung Folgendes eingeben: ildasm /source nerolib.dll /output=nerolib.il Nach diesem Aufruf bekommen wir zwei Dateien erstellt. Die "nerolib.il" und die "nerolib.res". Für uns ist nur die nerolib.il wichtig. 4. Als Nächstes öffnen wir die Datei nerolib.il mit einem Texteditor und suchen nach Suchbegriff "_SinkHelper". Der erste Punkt, den wir finden, sollte.class private auto ansi sealed _INeroEvents_SinkHelper extends [mscorlib]system.object implements NEROLib._INeroEvents sein. Hier ändern wir das private nun zum public. Anschließend suchen wir weiter nach Klassen, die die Endung _SinkHelper haben und führen dieselbe Änderung dort ebenfalls durch! 5. Wenn wir die Änderungen erfolgreich vorgenommen haben, können wir die geänderte Datei wieder zu einer für uns nützlichen Assembly konvertieren. Dies ist mit dem Befehl "ilasm.exe" realisierbar! Hierfür geben wir in der Eingabeaufforderung Folgendes ein: ilasm /dll nerolib.il /output=nerolib_new.dll 2

3 Hinweis: Die Datei muss beim Einbinden in das Projekt wieder nerolib.dll heißen, da diese ansonsten nicht korrekt funktioniert. Dies war nun der erste Teil, mit dem wir die für uns benötigte Assemblydatei erstellen!!! Erstellen eines Programmes zum Brennen von Daten auf CD Ich möchte euch begrüßen zum zweiten Teil dieses Tutorials. In diesem Teil werden wir eine kleine Applikation erstellen, mit der wir zwei Testdateien auf eine CD Brennen. Als Erstes erstellen wir uns ein Grundgerüst für dieses kleines Testprogramm. Mein Quellcode: using System; using System.Drawing; using System.Collections; using System.ComponentModel; using System.Windows.Forms; using System.Data; namespace Brennen / <summary> / Zusammenfassende Beschreibung für Form1. / </summary> public class Form1 : System.Windows.Forms.Form private System.Windows.Forms.Button btn_brennen; private System.Windows.Forms.ComboBox cmb_brennerauswahl; private System.Windows.Forms.ProgressBar prgbar_fortschritt; / <summary> / Erforderliche Designervariable. / </summary> private System.ComponentModel.Container components = null; public Form1() Erforderlich für die Windows Form-Designerunterstützung InitializeComponent(); TODO: Fügen Sie den Konstruktorcode nach dem Aufruf von InitializeComponent hinzu / <summary> / Die verwendeten Ressourcen bereinigen. / </summary> 3

4 protected override void Dispose( bool disposing ) if( disposing ) if (components!= null) components.dispose(); base.dispose( disposing ); #region Windows Form Designer generated code / <summary> / Erforderliche Methode für die Designerunterstützung. / Der Inhalt der Methode darf nicht mit dem Code-Editor geändert werden. / </summary> private void InitializeComponent() this.btn_brennen = new System.Windows.Forms.Button(); this.prgbar_fortschritt = new System.Windows.Forms.ProgressBar(); this.cmb_brennerauswahl = new System.Windows.Forms.ComboBox(); this.suspendlayout(); btn_brennen this.btn_brennen.location = new System.Drawing.Point(224, 160); this.btn_brennen.name = "btn_brennen"; this.btn_brennen.size = new System.Drawing.Size(176, 23); this.btn_brennen.tabindex = 0; this.btn_brennen.text = "Dateien Brennen"; prgbar_fortschritt this.prgbar_fortschritt.location = new System.Drawing.Point(8, 120); this.prgbar_fortschritt.name = "prgbar_fortschritt"; this.prgbar_fortschritt.size = new System.Drawing.Size(600, 16); this.prgbar_fortschritt.tabindex = 1; cmb_brennerauswahl this.cmb_brennerauswahl.dropdownstyle = System.Windows.Forms.ComboBoxStyle.DropDownList; this.cmb_brennerauswahl.location = new System.Drawing.Point(192, 40); this.cmb_brennerauswahl.name = "cmb_brennerauswahl"; this.cmb_brennerauswahl.size = new System.Drawing.Size(272, 21); this.cmb_brennerauswahl.tabindex = 2; Form1 this.autoscalebasesize = new System.Drawing.Size(5, 13); this.clientsize = new System.Drawing.Size(616, 198); this.controls.addrange(new System.Windows.Forms.Control[] this.cmb_brennerauswahl, this.prgbar_fortschritt, this.btn_brennen); this.name = "Form1"; this.text = "Tutorial Brennen"; 4

5 this.resumelayout(false); #endregion / <summary> / Der Haupteinstiegspunkt für die Anwendung. / </summary> [STAThread] static void Main() Application.Run(new Form1()); Zuerst erstellen wir eine neue Instanz von der NeroClass. private NEROLib.NeroClass neroclass = new NEROLib.NeroClass(); Diese Instanz benötigen wir später, um die Laufwerke zu ermitteln. Um die Laufwerke in einer Collection aufzunehmen, benötigen wir jetzt eine Instanz von der NeroDrivesClass. private NEROLib.NeroDrivesClass ndrives; Als Nächstes erstellen wir eine Methode, die uns unsere ComboBox mit den vorhandenen Brennern / Laufwerken füllt. In diesem Tutorial heißt diese Methode GetRecoderList(). Nun müssen wir uns als Erstes eine Liste der vorhandenen Brenner besorgen. Dies machen wir so: ndrives = (NEROLib.NeroDrivesClass)neroclass.GetDrives(NEROLib.NERO_MEDIA_TYPE.NERO_MEDIA_CD); Die Variable ndrives enthält nun alle von GetDrives übergebenen Laufwerke. Anschließend fügen wir mithilfe einer Foreach die Laufwerke der ComboBox hinzu: foreach(nerolib.nerodrive ndrive in ndrives) Laufwerkname in der ComboBox anlegen cmb_brennerauswahl.items.add(ndrive.devicename); 5

6 Nun müssen wir beim Start nur noch diese Methode aufrufen und erhalten so alle Laufwerke in der ComboBox! Als Nächstes schreiben wir die Funktion zum Brennen der Dateien. Diese wird für den Button "Dateien Brennen" hinterlegt. Diese Funktion nenne ich in diesem Tutorial btn_brennen_click, da dies auf ein Event (Click) des Buttons reagiert. Zu erst müssen wir einen neuen ISO-Track erstellen, in dem wir später die Verzeichnisse und Dateien hinterlegen. Neuen ISO-Track erstellen NEROLib.NeroISOTrackClass niso = new NEROLib.NeroISOTrackClass(); Als Nächstes vergeben wir einen Namen für den neuen ISO-Track. Dieser Name wird nach dem Brennen auch der Name der CD sein. Im nächsten Schritt müssen wir ein neues Verzeichnis erstellen, in dem wir die späteren Dateien einfügen. Dies machen wir mit folgender Syntax: Neues Verzeichnis erstellen NEROLib.NeroFolderClass nfolder = new NEROLib.NeroFolderClass(); Diesem Verzeichnis geben wir keinen Namen, da wir dies als RootFolder für den ISO-Track nutzen wollen. Nun erstellen wir ein zweites Verzeichnis. Zweites Verzeichnis erstellen NEROLib.NeroFolderClass nsecondfolder = new NEROLib.NeroFolderClass(); Verzeichnis benennen nsecondfolder.name = "TestFolder"; 6

7 Nachdem wir dem zweiten Verzeichnis einen Namen gegeben haben, fügen wir dies dem RootFolder hinzu: Verzeichnis zwei dem Root-Verzeichnis hinzufügen nfolder.folders.add(nsecondfolder); Jetzt fügen wir dem ISO-Track das Root-Verzeichnis hinzu: Root-Folder dem ISO-Track hinzufügen niso.rootfolder = nfolder; Nach all dem fehlen uns jetzt nur noch die Dateien, die wir auf die CD brennen wollen. Diese müssen wir nun den zwei Verzeichnissen hinzufügen. Dies funktioniert im Prinzip genau so wie mit den Verzeichnissen. Mit der Namenseigenschaft gibt man den Dateinamen auf der CD an, mit der SourceFilePath-Eigenschaft wird der Pfad und die zu erfassende Datei festgelegt. Zwei Dateien erstellen NEROLib.NeroFileClass nfile1 = new NEROLib.NeroFileClass();; NEROLib.NeroFileClass nfile2 = new NEROLib.NeroFileClass();; Eigenschaften der Files festlegen nfile1.name = "TestPack1.rar"; nfile1.sourcefilepath nfile2.name = "TestPack2.rar"; nfile2.sourcefilepath Dateien den Verzeichnissen hinzufügen nfolder.files.add(nfile1); nsecondfolder.files.add(nfile2); Als Nächstes müssen wir noch sagen, mit welchen Optionen wir den ISO-Track brennen wollen. In unserem Beispiel soll ein ISO-FileSystem erzeugt werden. Brennoptionen für den ISO-Track festlegen niso.burnoptions = NEROLib.NERO_BURN_OPTIONS.NERO_BURN_OPTION_CREATE_ISO_FS; Nun legen wir eine neue Globale Variable namens ndrive an. private NEROLib.NeroDrive ndrive; 7

8 Dieser Variable übergeben wir das von uns ausgewählte Laufwerk (Diese Variable stellt uns nun die Eigenschaften eines Laufwerkes zur Verfügung) Ausgewähltes Laufwerk an ndrive = (NEROLib.NeroDrive)ndrives.Item(cmb_brennerauswahl.SelectedIndex); Um die CD jetzt endgültig zu erstellen, rufen wir die BurnIsoAudioCD-Funktion von der Variable ndrive auf. CD erstellen und Daten auf CD brennen ndrive.burnisoaudiocd("","",false,niso,null,null,nerolib.nero_burn_flags.nero_burn_flag_write,10,nero Mit unserem jetzigen Programm würde es schon funktionieren, eine CD zu erstellen. Die Progressbar würde aber keinen Fortschritt anzeigen. Aus diesem Grund fügen wir nun noch eine Funktion zu dem Event, das uns von der NeroCOM-Schnittstelle zur Verfügung gestellt wird, hinzu. In diesem Programm nenne ich diese Funktion OnProgress(). Das OnProgress-Event erwartet zwei Parameter. Der erste Parameter gibt die Prozentzahl zurück, wie viel Daten auf die CD schon gebrannt wurden. Der zweite Parameter gibt zurück, ob das Brennen beendet wurde. private void OnProgress(ref int percent, ref bool fertig) prgbar_fortschritt.value = percent; Und hiermit wird nun auch der Fortschritt des Brennens angezeigt. Jetzt müssen wir noch dem OnProgress-Event einen neuen Eventhandler mit unserer Funktion hinzufügen. Das Event müssen wir in der Brennfunktion btn_brennen_click zuordnen, da hier ja erst die Wahl des Brenners aktualisiert wird. OnProgress-Event einen neuen Eventhandler hinzufügen ndrive.onprogress += new NEROLib._INeroDriveEvents_OnProgressEventHandler(OnProgress); Wichtig: Wird der Zwischenschritt über das ndrive-element nicht beachtet, so kann es Probleme mit der korrekten Funktion der Progressbar kommen. Ich hoffe, das euch das Tutorial gefallen hat!!! Mit freundlichen Grüßen, euer Günni 8

9 Und zum Abschluss noch einmal den komplette Quellcode: using System; using System.Drawing; using System.Collections; using System.ComponentModel; using System.Windows.Forms; using System.Data; namespace Brennen / <summary> / Zusammenfassende Beschreibung für Form1. / </summary> public class Form1 : System.Windows.Forms.Form private System.Windows.Forms.Button btn_brennen; private System.Windows.Forms.ComboBox cmb_brennerauswahl; private System.Windows.Forms.ProgressBar prgbar_fortschritt; private NEROLib.NeroClass neroclass = new NEROLib.NeroClass(); private NEROLib.NeroDrivesClass ndrives; private NEROLib.NeroDrive ndrive; / <summary> / Erforderliche Designervariable. / </summary> private System.ComponentModel.Container components = null; public Form1() Erforderlich für die Windows Form-Designerunterstützung InitializeComponent(); TODO: Fügen Sie den Konstruktorcode nach dem Aufruf von InitializeComponent hinzu GetRecoderList(); Laufwerke ermitteln prgbar_fortschritt.value = 0; / <summary> / Die verwendeten Ressourcen bereinigen. / </summary> protected override void Dispose( bool disposing ) if( disposing ) if (components!= null) components.dispose(); base.dispose( disposing ); 9

10 #region Windows Form Designer generated code / <summary> / Erforderliche Methode für die Designerunterstützung. / Der Inhalt der Methode darf nicht mit dem Code-Editor geändert werden. / </summary> private void InitializeComponent() this.btn_brennen = new System.Windows.Forms.Button(); this.prgbar_fortschritt = new System.Windows.Forms.ProgressBar(); this.cmb_brennerauswahl = new System.Windows.Forms.ComboBox(); this.suspendlayout(); btn_brennen this.btn_brennen.flatstyle = System.Windows.Forms.FlatStyle.System; this.btn_brennen.location = new System.Drawing.Point(224, 160); this.btn_brennen.name = "btn_brennen"; this.btn_brennen.size = new System.Drawing.Size(176, 23); this.btn_brennen.tabindex = 0; this.btn_brennen.text = "Dateien Brennen"; this.btn_brennen.click += new System.EventHandler(this.btn_brennen_Click); prgbar_fortschritt this.prgbar_fortschritt.location = new System.Drawing.Point(8, 120); this.prgbar_fortschritt.name = "prgbar_fortschritt"; this.prgbar_fortschritt.size = new System.Drawing.Size(600, 16); this.prgbar_fortschritt.step = 1; this.prgbar_fortschritt.tabindex = 1; cmb_brennerauswahl this.cmb_brennerauswahl.dropdownstyle = System.Windows.Forms.ComboBoxStyle.DropDownList; this.cmb_brennerauswahl.location = new System.Drawing.Point(192, 40); this.cmb_brennerauswahl.name = "cmb_brennerauswahl"; this.cmb_brennerauswahl.size = new System.Drawing.Size(272, 21); this.cmb_brennerauswahl.tabindex = 2; Form1 this.autoscalebasesize = new System.Drawing.Size(5, 13); this.clientsize = new System.Drawing.Size(616, 198); this.controls.addrange(new System.Windows.Forms.Control[] this.cmb_brennerauswahl, this.prgbar_fortschritt, this.btn_brennen); this.name = "Form1"; this.text = "Tutorial Brennen"; this.resumelayout(false); #endregion / <summary> / Der Haupteinstiegspunkt für die Anwendung. / </summary> 10

11 [STAThread] static void Main() Application.Run(new Form1()); # region Eigendefiniert Methoden/Funktionen private void GetRecoderList() Ermittle alle Laufwerke mit der Eigenschaft (siehe Media_type) ndrives = (NEROLib.NeroDrivesClass)neroclass.GetDrives(NEROLib.NERO_MEDIA_TYPE.NERO_MEDIA Alle ermittelten Laufwerke in der ComboBox anlegen foreach(nerolib.nerodrive ndrive in ndrives) Laufwerkname in der ComboBox anlegen cmb_brennerauswahl.items.add(ndrive.devicename); #endregion Funktion, die zwei Dateien auf eine CD brennt private void btn_brennen_click(object sender, System.EventArgs e) Neuen ISO-Track erstellen NEROLib.NeroISOTrackClass niso = new NEROLib.NeroISOTrackClass(); ISO-Track benennen niso.name = "TEST-CD"; Neues Verzeichnis erstellen NEROLib.NeroFolderClass nfolder = new NEROLib.NeroFolderClass(); Zweites Verzeichnis erstellen NEROLib.NeroFolderClass nsecondfolder = new NEROLib.NeroFolderClass(); Verzeichnis benennen nsecondfolder.name = "TestFolder"; Verzeichnis zwei dem Root-Verzeichnis hinzufügen nfolder.folders.add(nsecondfolder); Root Folder dem ISO-Track hinzufügen niso.rootfolder = nfolder; Zwei Dateien erstellen NEROLib.NeroFileClass nfile1 = new NEROLib.NeroFileClass(); NEROLib.NeroFileClass nfile2 = new NEROLib.NeroFileClass(); Eigenschaften der Files festlegen nfile1.name = "TestPack1.rar"; nfile1.sourcefilepath nfile2.name = "TestPack2.rar"; nfile2.sourcefilepath 11

12 Dateien den Verzeichnissen hinzufügen nfolder.files.add(nfile1); nsecondfolder.files.add(nfile2); Brennoptionen für den ISO Track festlegen niso.burnoptions = NEROLib.NERO_BURN_OPTIONS.NERO_BURN_OPTION_CREATE_ISO_FS; Ausgewähltes Laufwerk übergeben ndrive = (NEROLib.NeroDrive)ndrives.Item(cmb_brennerauswahl.SelectedIndex); Hinzufügen des OnProgress-Events zum ausgewählten Laufwerk ndrive.onprogress += new NEROLib._INeroDriveEvents_OnProgressEventHandler(OnProgress); CD erstellen und Daten auf CD brennen ndrive.burnisoaudiocd("","",false,niso,null,null,nerolib.nero_burn_flags.nero_burn_flag_w private void OnProgress(ref int percent, ref bool abort) prgbar_fortschritt.value = percent; Verweise [1] [2] 12