Freigeben über

Aktualisieren von SharePoint-Hostwebkomponenten

  • Artikel

Machen Sie sich vor Beginn mit dem Thema Aktualisieren von SharePoint-Add-Ins und den darin aufgef?hrten erforderlichen Komponenten und Kernkonzepten vertraut.

Das Add-In kann zwei Arten von Komponenten in einem Hostweb mit aussagekr?ftigem Markup in der SharePoint-Add-In installieren: benutzerdefinierte Aktionen und Add-In-Webparts. Die Aktualisierung dieser Komponenten ist im Hostweb einfacher als im Add-In-Web. Es wird keine Aktualisierungssemantik ben?tigt. ?ndern Sie einfach die benutzerdefinierten Aktionen und Add-In-Webparts oder f?gen Sie diese neu hinzu. Wenn das SharePoint-Add-In aktualisiert wurde, wendet SharePoint immer alle neuen Elementmanifestdateien an und wendet alle ge?nderten Elementmanifestdateien mit der neuesten Version erneut an. Bei erneuter Anwendung wird kein Schaden angerichtet; zum Beispiel wird eine Men?band-Schaltfl?che f?r eine benutzerdefinierte Aktion nicht mehrmals zu dem Men?band hinzugef?gt.

Wenn Sie ein Add-In-Webpart aktualisieren, ersetzt SharePoint die alte Version durch die neue Version im Webpartkatalog. Achten Sie darauf, die Eigenschaft Name des ClientWebPart-Objekts zu ändern, wenn Sie ein App-Webpart aktualisieren. Dies gewährleistet beim Aktualisieren der App, dass SharePoint die alte Version des App-Webparts (diese ist nicht mehr Teil der App) von allen Seiten entfernt, zu denen sie hinzugefügt wurde. Die Benutzer müssen die neue Version erneut zu den Seiten hinzufügen.

Wenn Sie die Name-Eigenschaft unverändert lassen, verbleibt die alte Version auf Seiten, auf denen sie hinzugefügt wurde, wodurch es unwahrscheinlich ist, dass Benutzer wissen, dass eine neue Version des Add-In-Webparts verfügbar ist. Wenn das Add-In-Webpart zu anderen Seiten hinzugefügt wird, wird die neue Version hinzugefügt, sodass dieselbe Version eines SharePoint-Add-Ins auf verschiedenen Seiten unterschiedliche Add-In-Teile aufweisen würde.

Sie k?nnen programmgesteuert andere Arten von Hostweb-Komponenten bereitstellen, indem Sie einen mit einem InstalledEventEndpoint-Element im Add-In-Manifest registrierten Remoteereignisempf?nger verwenden. Sie sollten einen UpgradedEventEndpoint-Empf?nger verwenden, um Komponenten zu aktualisieren, die urspr?nglich mit einem InstalledEventEndpoint-Empf?nger bereitgestellt wurden. Eine Beschreibung der UpgradedEventEndpoint-Empf?nger finden Sie unter Erstellen eines Handlers f?r das Aktualisierungsereignis in SharePoint-Add-Ins.

Nächste Schritte

Wechseln Sie zu Wichtige Schritte beim Aktualisieren eines Add-Ins oder rufen Sie direkt einen der folgenden Artikel auf, um zu erfahren, wie Sie die n?chste Hauptkomponente Ihres SharePoint-Add-Ins aktualisieren.

Siehe auch