NetOffice - Ein versionsunabhängiger Wrapper für MS-Office

Fragen zur Entwicklung mit NetOffice z.B. wie sende ich eine E-Mail oder wie öffne ich ein Word Dokument bitte im Forum  Office-Technologien und nicht hier.


NetOffice - .NET Wrapper Assemblies für den Zugriff auf Microsoft Office, Excel, Word, Outlook, PowerPoint, Access

 http://netoffice.codeplex.com


- Office Integration ohne Versionsbeschränkung
- Alle Objekte, Methoden, Properties und Events der Office Versionen 2000, 2002, 2003, 2007, 2010 enthalten
- Attribute Konzept und XML Source Doku zur Information welche Office Version(en) die jeweilige Methode oder Property anbietet (siehe angehängtes Bild)
- Syntaktisch und semantisch identisch zu den Interop Assemblies
- Reduzierter und besser lesbarer Code durch automatische Verwaltung von COM Proxies
- Keine Deployment Hürden, keine problematische Registrierung, keine Abhängigkeiten, keine Interop Assemblies, kein VSTO notwendig
- Mit jeder .NET Version ab 2.0 verwendbar
- Problemlose Addin Entwicklung

- Dokumenation und Beispielprojekte inkl. Addins für alle Office Produkte in C# und VB.NET auch online verfügbar

Beispielcode für die Erstellung eines neuen TaskItem in Outlook(Example02.csproj)

C#-Code:

// Initialize Api COMObject Support    LateBindingApi.Core.Factory.Initialize();    // Create an Outlook Application object.    Outlook.Application outlookApplication = new Outlook.Application();    // Create a new TaskItem.    Outlook.TaskItem newTask = outlookApplication.CreateItem(OlItemType.olTaskItem) as Outlook.TaskItem;    // Configure the task at hand and save it.    newTask.Subject = "check for NetOffice.DeveloperToolbox updates";    newTask.Body = "check updates here: http://netoffice.codeplex.com";    newTask.DueDate = DateTime.Now;    newTask.Importance = OlImportance.olImportanceHigh;    newTask.Save();    // close outlook and dispose    outlookApplication.Quit();    outlookApplication.Dispose();

Fragen, Kritik, Verbesserungsvorschläge und Bug Reports sind natürlich sehr willkommen.

Schlagwörter: Office Excel Word Outlook PowerPoint Access


Screenshot: IntelliSense Unterstützung in C# für Versionsinformation eines Property.

Habs nicht probiert aber auf sowas habe ich schon lange gewartet!!! :)

Hoffe bald einmal das Framework einsetzen zu können.

Lg, XXX

Klingt sehr gut. Gibt es auch die Möglichkeit beim Erstellen anzugeben, welche (minimale/exakte) Application-Version verwendet werden soll?

Also für den Fall, dass mehrere Installiert sind und man sich daher nicht sicher sein kann, dass gerade die gewünschte Version als Standardanwendung eingetragen ist.

danke das schaue ich mir mal an.

Wie sieht es mit 32/64Bit (AnyCPU) Kompatibilität aus? Was muss man da alles beachten?

Zitat von Sebastian.Lange:

Ich erstelle gerade einen kleinen Guide bzw. kurze Übersicht zu dem Thema. Release 0.9 (Beta) wird auch x64 Assemblies für alle .NET Versionen ab .NET 2.0 enthalten.

Danke

ah, noch etwas. Wird es das Projekt auch als NuGet Paket geben?

@Sebastian.Lange

installiere die 90 Tage Win7 x64 Trial, da kannst du es testen.

Ich habe Release 0.9 soeben fertig gestellt und in der technischen Dokumentation einen entsprechnden Eintrag zur 32Bit/64Bit Thematik verfasst.

 Documentation > Tec_Documentation_German > Tec_Documentation_German_32Bit_64Bit

Sofern der Fragen offen lässt solls mir doch bitte einer sagen

Du meinst das Release Tag?
Bei kleineren Bugfixes bzw. Anpassungen/Erweiterungen update ich das Tag ohne auf der Codeplex Seite jedesmal ein neues Release zu erstellen. Wenn du z.B. ein Issue erstellst kümmere ich mich sofort um den Fehler und update dieses Release Tag quasi noch am gleichen Tag. Das Release auf der Webseite muss immer etwas warten. 3 neue Releases am Tag würden keinem nützen glaube ich.

Hallo,

lassen mit NetOffice auch die Office-Anwendungen in die eigene Applikation einbetten?

Ich muss für ein aktuelles Projekt Excel-Dateien innerhalb meiner Anwendung anzeigen. Bisher habe ich es mit einem WebBrowser-Control versucht. Dies funktioniert jedoch ohne Änderung an der Registry nicht richtig.

Daniel

Hallo Sebastian,

coole API - ich brauche sie gerade wieder für ein kleines Projekt. Vielen Dank dafür!

Und (wie könnte es anders sein) dazu gleich eine Frage. Ich muss mit meinem Programm große Datenmengen (>50.000 Zeilen, 6 Spalten) in Excel importieren. Wenn ich die händisch (Zelle für Zelle) hinzufüge dauert das ewig.
Gibt es eine Möglichkeit das zu beschleunigen, beispielsweise über einen CSV-Import?

EDIT: Da habe ich wohl nicht klar genug formuliert. Die Frage bezieht sich ganz konkret auf die netoffice-API: Ist ein CSV-Import mit dieser API möglich? Und wenn ja, wie?

Viele Grüße,
Markus :)

Hallo,
ja - Office muss installiert sein - die API ist "nur" eine LateBinding-Wrapper um
die OfficeAPI - Vorteil: Es muss keine bestimmte Office-Version installiert sein.

Es handelt sich dabei nicht um eine vollständig neue Implementierung der OfficeAPI

LG
Achim

Habs getestet. Wunderbar :-)

Genial!
Ich habe zwar nur Excel getestet, muss aber sagen: Hut ab! Auch allem wg. der vielen Arbeit, die ganzen Properties nachzubauen und alles so fein zu dokumentieren und zu "bebeispielen".

Nur zur Info: Ich habe bisher versucht:
- direktes COM: ist an Unterschieden zwischen den Excelversionen gescheitert
- Xml-Writer von  CarlosAg: ein recht gutes Teil, wenn man nur schreiben will, läuft voll ohne Excel. Ich aber muss in bestehende Blätter schreiben, und da gibts Schwierigkeiten mit der Zelladressierung.
- Ado.Net: immer wieder Fehler "Installierbares Isam nicht gefunden" auf diversen Maschinen in freier Wildbahn.

-christoph

Es gibt ein neues Release

 NetOffice Release 1.1

Es behebt einen kritischen Fehler im Eventsystem von NetOffice.
Sie dazu  Issue 16314

Der Support für MS-Project verzögert sich leider etwas da die Italiener ausgesprochen träge reagieren was die Tests betrifft.

Hallo Sebastian,
super Arbeit!
Kann man das "Speichern als PDF" auch über deinen Wrapper ausführen?

Grüße
ebenfalls Sebastian

Super, vielen Dank. Ich probier' das dann mal! :-)

Ab sofort verfügbar ist:

 NetOffice Release 1.2

- IntelliSense zeigt nun zusätzlich für Properties "Get" oder "Get/Set"
- Unterstützung für MS-Project 2007 und 2010
- Deutliche Performance Verbesserung

Ein ausführlicher Performance Vergleich ist nun zusätzlich verfügbar:

 Performance Vergleich: Interop, Dynamics, Visual Basic, NetOffice


Geplant für Release 1.3
- Unterstützung für ältere MS-Project Versionen
- Unterstützung für MS-Visio (wurde angefragt)
- Weitere Vorschläge durch Community Feedback willkommen

[offtopic]
Die fetten ReleaseTags im Quellcode habe ich entfernt.
[/offtopic]

Ab sofort verfügbar ist die NetOffice Developer Toolbox.

Die Developer Toolbox ist ein Productivity Tool für den Office-Entwickler.
Es umfasst die folgenden Funktionalitäten:

- Office Compatibility
- Application Observer
- Registry Editor
- Addin Guard
- Outlook Security

Die Dokumenation befindet sich hier:
 Developer Toolbox Online Dokumenation

Ich möchte die einzelnen Funktionen ganz kurz umschreiben.

Office Compatibility

Wer eine Office Lösung entwickelt die mit mehreren oder allen Office Versionen kompatibel sein muss, steht vor dem Problem das er nur die Funktionalitäten ansprechen darf die in allen unterstützen Versionen zur Verfügung stehen. NetOffice bietet daher als einzige API einen entsprechenden Hinweis als IntelliSense Text, während der Entwicklung an, von welcher Office Version die jeweilige Funktionalität unterstützt wird. Auch wenn dieses Feature eine grosse Hilfe darstellt, reicht es in der Praxis nicht aus um sicherzustellen das man mit allen Versionen einer Office Anwendung kompatibel ist. Die Office Compatibility Komponente führt eine statische Code-Analyse mit Hilfe von Mono.Cecil durch und analysiert Assemblies die NetOffice verwenden darauf mit welchen Office Versionen sie kompatibel sind. Eine entsprechende Übersicht hilft dem Entwickler die inkompatiblen Aufrufe zu identifizieren.

Application Observer

Wer über längere Zeit an grösseren Office Lösungen arbeitet kennt das Problem.
Ein Fehler triff auf, der Debugging Prozess wird abgebrochen, vorhandener Cleanup Code wird damit nicht ausgeführt. Die Instanz der Office Anwendung wird nicht beendet und verbleibt im Speicher. Schnell befinden sich innerhalb weniger Minuten viele dieser verwaisten Instanzen im Speicher die via Task-Manager entfernt werden müssen. Der Application Observer überwacht die Anzahl laufender Instanzen von ausgewählten Office Anwendungen und zeigt diese Information auf Wunsch als Tray-Icon an. Darüber hinaus kann man einen systemweiten Hotkey festlegen um diese Instanzen schnell und unkompliziert zu entfernen. Die Hotkey Klasse stammt dabei von MyCSharp. Vielen Dank an Floste. Einen entsprechenden Hinweis im Code und in der About Box habe ich natürlich nicht vergessen.

Registry Editor

Der Registry Editor ist ein technischer und optischer Klon des bekannten Windows Registry Editors. Er bietet jedoch nur die Schlüssel für MS-Office an. Nerviges scrollen wird dadurch überflüssig.

Addin Guard

Entwickler die COMAddins für eine Office Anwendung schreiben haben oft das Problem das Sie nicht sicher sind ob Ihr Addin ordnungsgemäss geladen wird.
Bei einem auftretenden Fehler, z.B. einer fehlenden Abhängigkeit setzen Office Anwendungen das Ladeverhalten von Addins komentarlos zurück oder markieren es als deaktiviert. Viele Entwickler bauen daher MessageBox Ausgaben in ihren Code und prüfen permanent mit nervösem Blick die Registry-Werte Ihres Addins.
Addin Guard schafft hier Abhilfe in dem es das Ladeverhalten von Addins also ihren Aktivierungsstatus überwacht und ein Meldungsfenster oder eine Tray-Benachrichtung anzeigt wenn sich das Ladeverhalten ändert. Auf Wunsch kann Addin Guard das Ladeverhalten auch direkt zurücksetzen.

Outlook Security

Ein Entwickler der MS-Outlook via COM ansprechen bzw. automatisieren möchte steht vor dem Problem das Outlook einen Security Dialog einblendet, der zur Autoriserung auffordert, wenn man auf bestimmte Teile des Objektmodells zugreift. Mit Einführung dieses Sicherheits-Features wurde sehr schnell ein Tool mit dem Namen ClickYes populär das im Hintergrund läuft und diesen Dialog automatisch bestätigt. Outlook Security tut es dem bekannten Tool ClickYes nach indem es diesen Dialog automatisch bestätigt und hat darüber hinaus noch einen weiteren Vorteil. Die tatsächliche Funktionalität ist in das beiliegende Assembly NetOffice.OutlookSecurity.dll ausgelagert. Wer möchte kann dieses Assembly nutzen oder den Source Code direkt einbinden. Ein Addin kann damit seine eigene ClickYes Funktionalität mitbringen und auf dem Zielsystem muss kein extra Tool installiert werden. Wie man das Assembly NetOffice.OutlookSecurity.dll nutzt ist in der Online Dokumentation beschrieben.

 Zum Download gehts hier

Die Developer Toolbox benötigt das .NET 4 Framework.
Das Client Profile ist dabei ausreichend.

Hallo!

Habe NetOffice heute auch mal getestet: Läuft wirklich toll.

Evtl. noch ein kleiner Hinweis:
Wenn man z.B. Application in einer using-Anweisung verwendet, erwarte ich, dass neben Dispose gegebenenfalls weitere Methoden (z.B. Quit) automatisch aufgerufen werden.

Zusätzlich sollte evtl. auch ein Destructor eingerichtet werden (siehe auch  Dispose implementieren und verwenden (IDisposable)), welcher Dispose(false) aufruft.

Ich benutze zwar z.Zt. noch einen eigenen Wrapper, bin aber geneigt, auf NetOffice umzusteigen.