Schritt 2: Codieren des Webparts

Artikel
09/18/2014

Letzte Änderung: Dienstag, 20. Juli 2010

Gilt für: SharePoint Server 2010

In diesem Thema wird erklärt, wie Sie Code schreiben, der die Word-Automatisierungsdienste-Dokumentkonvertierung mithilfe eines SharePoint Server 2010-Webparts initiiert. Ein Endbenutzer kann Dokumente in der angegebenen SharePoint-Dokumentbibliothek konvertieren, indem er auf eine Schaltfläche in einem Webpart klickt.

Schreiben von Code zum Konvertieren der Dokumentbibliothek

Mit den folgenden Verfahren fügen Sie dem Webpart eine Schaltfläche hinzu und fügen dann im Click-Ereignis Code für die Schaltfläche hinzu, über die eine Word-Automatisierungsdienste-Dokumentkonvertierung gestartet wird.

So fügen Sie dem Webpart eine Schaltfläche hinzu

Erweitern Sie im Visual Studio 2010-Projekt für das Webpart-Lösungsbeispiel im Projektmappen-Explorer den Knoten VisualWebPart1, klicken Sie mit der rechten Maustaste auf VisualWebPart1UserControl.ascx, und klicken Sie dann auf Designer anzeigen.
Ziehen Sie aus Toolbox ein Schaltflächen-Steuerelement auf die Designeroberfläche.
Markieren Sie die Schaltfläche im Designer, doppelklicken Sie unter Eigenschaften in das Feld (ID), geben Sie btnSubmit ein, und drücken Sie dann die EINGABETASTE.
Führen Sie unter Eigenschaften einen Bildlauf hinunter zu Text aus, doppelklicken Sie in das Feld Text, geben Sie Dokumentbibliothek konvertieren ein, und drücken Sie dann die EINGABETASTE.

So konvertieren Sie die Dokumente

Wenn VisualWebPart1UserControl.ascx im Designer geöffnet ist, vergewissern Sie sich, dass die Schaltfläche auf der Webpartoberfläche ausgewählt ist.
Klicken Sie unter Eigenschaften auf die Schaltfläche mit dem Blitz, um in die Ansicht Ereignisse zu wechseln, und doppelklicken Sie in das Ereignisfeld Klicken. Der btnSubmit_Click-Ereignishandler wird in VisualWebPart1UserControl.ascx.cs erstellt.
Fügen Sie in VisualWebPart1UserControl.ascx.cs eine using-Direktive für Word-Automatisierungsdienste hinzu.
```
using Microsoft.Office.Word.Server.Conversions;
```
Die Hauptobjekte, die zum Durchführen der Word-Automatisierungsdienste-Dokumentkonvertierung verwendet werden, befinden sich im Microsoft.Office.Word.Server.Conversions-Namespace.
Fügen Sie in der btnSubmit_Click-Methode den folgenden Code hinzu.
```
ConversionJob myJob = new ConversionJob("Word Automation Services");
```
Das Zeichenfolgenargument, das an den ConversionJob-Konstruktor übergeben wird, muss der Name der Dienstanwendungsinstanz für Word-Automatisierungsdienste sein, wie unter Konfigurieren von Word Automation Services für die Entwicklung beschrieben. Der Name der Dienstanwendungsinstanz wird auf der Seite Dienstanwendungen verwalten in der SharePoint-Zentraladministration angezeigt.
Als Nächstes legen Sie Eigenschaften für den ConversionJob-Auftrag fest, indem Sie folgenden Code hinzufügen.
```
myJob.Settings.OutputFormat = SaveFormat.PDF;
   myJob.Settings.OutputSaveBehavior = SaveBehavior.AppendIfPossible;
```
Die zwei Einstellungen im Code geben Folgendes an:
- Das Ausgabeformat soll PDF sein.
- Die Ausgabedateien sollen als neue Version an vorhandene Dateien angehängt werden, wenn die Versionsverwaltung aktiviert ist, andernfalls sollen sie die vorhandenen Dateien überschreiben.

Legen Sie die Anmeldeinformationen fest, die beim Ausführen des Konvertierungsauftrags angegeben werden sollen.

Wichtig
Diese Einstellung gibt an, dass für alle Lese- bzw. Schreibvorgänge für Dokumente die Anmeldeinformationen desjenigen Benutzers verwendet werden sollen, der auf die Schaltfläche klickt. Word-Automatisierungsdienste verwendet standardmäßig den anonymen Kontext, daher ist es wichtig, diese Eigenschaft festzulegen.

myJob.UserToken = SPContext.Current.Web.CurrentUser.UserToken;

Anschließend geben Sie die Eingabebibliothek an, die die zu konvertierenden Dateien enthält, sowie die Ausgabebibliothek für die konvertierten Dateien.

SPWeb myWebSite = SPContext.Current.Web;
   SPList inputLibrary = myWebSite.Lists["Input"];
   SPList outputLibrary = myWebSite.Lists["Output"];
   myJob.AddLibrary(inputLibrary, outputLibrary, true);

Zuletzt vervollständigen Sie den Code für die btnSubmit_Click-Methode, indem Sie Code zum Starten des Word-Automatisierungsdienste-Konvertierungsauftrags hinzufügen.
```
myJob.Start();
```
Klickt ein Benutzer auf die Schaltfläche im Webpart, wird ein Konvertierungsauftrag für die Dateien in der Eingabebibliothek initiiert.

Siehe auch

Aufgaben

Schritt 1: Einrichten des Visual Studio 2010-Projekts für eine Webpartlösung

Schritt 3: Erstellen und Bereitstellen der Webpartlösung

Konzepte

Exemplarische Vorgehensweise: Erstellen eines Webparts mithilfe von Word Automation Services

Share via