Freigeben über

Gewusst wie: Erstellen eines Webparts zum Hosten einer externen Anwendung

  • Artikel

Letzte Änderung: Donnerstag, 1. September 2011

Gilt für: SharePoint Foundation 2010

Dieses Thema enthält einen Überblick über das Erstellen eines Webparts, der eine Anwendung hostet, bei der es sich nicht um eine SharePoint-Anwendung handelt. Die Anwendung befindet sich unter Umständen in einer anderen Domäne als die Microsoft SharePoint Foundation-Webanwendung, in der das Webpart verwendet wird. In der Regel besitzt das Webpart bearbeitbare Eigenschaften, dann müssen Sie auch ein Toolpart für das Webpart erstellen.

So erstellen Sie das Webpart

  1. Starten Sie in Microsoft Visual Studio 2010 ein leeres SharePoint-Projekt.

  2. Fügen Sie dem Projekt ein Webpart hinzu, und öffnen Sie die cs- oder vb-Quellcodedatei.

  3. Fügen Sie eine using-Anweisung (Imports in Visual Basic) für den Microsoft.SharePoint.WebPartPages-Namespace hinzu.

  4. Legen Sie fest, dass die WebPart-Klasse von ClientApplicationWebPartBase anstatt von der standardmäßigen WebPart-Klasse erbt.

  5. Überschreiben Sie nach Bedarf den Klassenkonstruktor und die Methoden CreateChildControls und RenderContents.

    Wenn Sie die Verwendung des Webparts mit einem benutzerdefinierten EAP (External Application Provider) ermöglichen möchten, sollte die CreateChildControls-Methode Folgendes bewirken:

    1. Aufrufen der geerbten GetExternalApplicationRequestResult()-Methode

    2. Aufrufen der geerbten GetInitParams()-Methode

    3. Aufrufen der GetContentControl(String)-Methode des SPExternalApplicationRequestResult-Objekts, das durch den Aufruf von GetExternalApplicationRequestResult() zurückgegeben wird, und Übergeben des String-Objekts, das durch den Aufruf von GetInitParams() zurückgegeben wird, als Parameter.

    Wenn kein benutzerdefinierter EAP erstellt und beim Webdienst mit der Webanwendung registriert wurde, bewirkt diese Aufrufserie nichts.

  6. Wenn das Externes Anwendungs-XML des Webparts benutzerdefinierte Eigenschaften enthält, dann müssen Sie einen benutzerdefinierten EAP erstellen, um diese Eigenschaften zu lesen. Beim Erstellen des benutzerdefinierten EAP implementieren Sie die OnApplicationWebPartCreateChildControls(SPExternalApplicationRequestProperties)-Methode. Weitere Informationen zum Erstellen eines benutzerdefinierten EAP finden Sie unter Gewusst wie: Erstellen eines benutzerdefinierten externen Anwendungsanbieters.

  7. Wenn das Webpart bearbeitbare Eigenschaften aufweist, implementieren Sie die geerbte CreateEditorParts()-Methode, um ein Objekt der Toolpartklasse zu erstellen. Weitere Informationen zu dieser Klasse finden Sie im Verfahren So erstellen Sie das Toolpart.

So erstellen Sie das Toolpart

  1. Fügen Sie dem Projekt ein weiteres Webpart hinzu.

  2. Legen Sie fest, dass die Klasse von EditorPart anstatt von der standardmäßigen WebPart-Klasse erbt.

  3. Fügen Sie eine Implementierung der SyncChanges()-Methode hinzu, um bearbeitbare Eigenschaften aus dem Webpart in bearbeitbare Steuerelemente im Toolpart einzulesen.

  4. Fügen Sie eine Implementierung der ApplyChanges()-Methode hinzu, um Werte aus den Steuerelementen im Toolpart zu lesen, und weisen Sie diese den Eigenschaften des Webparts zu.

  5. Überschreiben Sie die Methoden CreateChildControls, RenderContents und weitere Member nach Bedarf.