Schritt für Schritt: Entwickeln einer benutzerdefinierten Anwendung mit Excel Web Services

  • Artikel

Die exemplarische Vorgehensweise in diesem Abschnitt beschreibt das Verfahren für den Zugriff auf die Excel Web Services von einer mit Microsoft Visual C# erstellten Anwendung.

Diese exemplarische Vorgehensweise vermittelt Folgendes:

  • Erstellen einer Clientanwendung mithilfe der Visual Studio-Projektvorlage für Konsolenanwendungen.

  • Hinzufügen eines Webverweises für die Excel Web Services.

  • Schreiben von Code für den Zugriff auf den Webdienst. Sie erfahren, wie eine Arbeitsmappe geöffnet wird, die Sitzungs-ID abgerufen wird, die Standardanmeldeinformationen übergeben werden, Webdienst-Versionsinformationen abgerufen werden, das Bereichskoordinatenobjekt definiert wird, der Bereich, der das Bereichskoordinatenobjekt verwendet, abgerufen wird, die Arbeitsmappe geschlossen wird und die SOAP-Ausnahme aufgefangen wird.

  • Testen und Ausführen der Konsolenanwendung im Debugmodus.

Eine Clientkonsolenanwendung ist nur eine Möglichkeit, um auf den Webdienst zuzugreifen. Ein gängigeres Verfahren ist die Verwendung von Serveranwendungen wie Microsoft ASP.NET-Anwendungen. Im Rahmen dieser exemplarischen Vorgehensweise wird der Einfachheit halber eine Konsolenanwendung als Beispiel verwendet, um die Aspekte der Excel Web Services-API zu beleuchten.

Voraussetzungen

In order to complete this walkthrough, you will need:

  • Microsoft SharePoint Server 2010.

  • Visual Studio oder ein vergleichbares mit Microsoft .NET Framework kompatibles Entwicklungstool.

  • Ausreichende Berechtigungen (mindestens die Berechtigung "Anzeigen"), um auf die Excel Web Services auf dem Computer zugreifen zu können, auf dem sich SharePoint Server 2010 befindet.

    Hinweis

    Weitere Informationen zu Arbeitsmappenberechtigungen finden Sie weiter unten im Abschnitt „Arbeitsmappenberechtigungen“.

  • Eine auf einem lokalen Laufwerk oder in einer lokalen SharePoint-Dokumentbibliothek installierte Beispiel-Arbeitsmappe.

  • Einen vertrauenswürdigen Speicherort zum Speichern von Arbeitsmappen, auf die Sie mithilfe der Excel Web Services zugreifen möchten. Wenn die Arbeitsmappen nicht an einem vertrauenswürdigen Speicherort gespeichert sind, führen die Excel Web Services-Aufrufe zum Öffnen der Arbeitsmappe zu einem Fehler. Bei dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass sich die Arbeitsmappe auf dem lokalen Computer befindet.

    Hinweis

    Informationen zum Vertrauen eines Speicherorts finden Sie unter How to: Trust a Location und How to: Trust Workbook Locations Using Script.

  • Erstellen der Arbeitsmappe mithilfe von Excel.

  • Sie müssen die Arbeitsmappe als XLSX- oder XLSB-Datei speichern.

Die Arbeitsmappe, die in diesem Beispiel verwendet wird, trägt den Namen "Sheet1". Das Arbeitsblatt enthält 11 Spalten und 19 Zeilen. Jede Zelle von A1 bis K19 enthält einen numerischen Wert, z. B. 4245,955, 6960,673 usw.

Arbeitsmappenberechtigungen

  • Zum Abrufen der gesamten Arbeitsmappe (z. B. durch Aufrufen der GetWorkbook-Methode) benötigt der Aufrufer die Berechtigung "Öffnen" für die Arbeitsmappe.

  • Zum Aufrufen der GetApiVersion-Methode sind keine Berechtigungen erforderlich.

  • Für die übrigen Excel Web Services-Methoden benötigt der Aufrufer die Berechtigung "Anzeigen" (in Microsoft SharePoint Foundation) oder "Lesen" (auf einer Dateifreigabe ) für die Arbeitsmappe.

    Hinweis

    Weitere Informationen zum Festlegen von Berechtigungen finden Sie in der Dokumentation zu SharePoint Foundation.

Siehe auch