Exemplarische Vorgehensweise: Entwickeln einer benutzerdefinierten Anwendung mithilfe der Excel-Webdienste

Artikel
09/18/2014

Letzte Änderung: Mittwoch, 24. März 2010

Gilt für: SharePoint Server 2010

Die exemplarische Vorgehensweise in diesem Abschnitt beschreibt das Verfahren für den Zugriff auf die Excel-Webdienste 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-Webdienste.
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-Webdienste-API zu beleuchten.

Voraussetzungen

Zum Ausführen dieser exemplarischen Vorgehensweise ist Folgendes erforderlich:

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-Webdienste 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 Beispielarbeitsmappe, die auf einem lokalen Laufwerk oder in einer lokalen SharePoint-Dokumentbibliothek installiert ist.

Hinweis
Weitere Informationen zu Arbeitsmappenberechtigungen finden Sie weiter unten im Abschnitt "Arbeitsmappenberechtigungen".

Einen vertrauenswürdigen Speicherort zum Speichern von Arbeitsmappen, auf die Sie mithilfe der Excel-Webdienste zugreifen möchten. Wenn die Arbeitsmappen nicht an einem vertrauenswürdigen Speicherort gespeichert sind, führen die Excel-Webdienste-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 Festlegen eines vertrauenswürdigen Speicherorts finden Sie unter Gewusst wie: Festlegen eines Speicherorts als vertrauenswürdig und How to: Trust Workbook Locations Using Script.

Sie müssen die Arbeitsmappe mit Excel erstellen.
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-Webdienste-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.