Mobile Webpartseiten und -adapter

Letzte Änderung: Mittwoch, 2. Februar 2011

Gilt für: SharePoint Foundation 2010

Dieses Thema bietet eine Übersicht über das SharePoint Foundation Adapter Framework für das Rendern des Webparts auf mobilen Geräte.

Anpassung an mobile Geräte in SharePoint Foundation

Entwickler können Webpartseiten auf SharePoint Foundation-Websites mittels einer Variante des mobilen Adaptersystems von Microsoft ASP.NET 3.5 für mobile Geräte zugänglich machen. Das mobile Anpassungssystem in SharePoint Foundation ist im Wesentlichen identisch:

1. Bei Anforderung einer Webpartseite erkennt der Front-End-Webserver anhand des Anforderungsheaders, welche Art von Gerät die Anforderung stellt.

2. Wenn ein mobiles Gerät die Anforderung stellt, schlägt ASP.NET jedes Webpart auf der angeforderten Seite in der Datei compat.browser nach, um zu prüfen, welcher mobile Adapter, falls vorhanden, diesem zugeordnet ist.

3. Für jedes der Ereignisse Init, Load, PreRender und UnLoad() gilt Folgendes: Wenn ein Webpart einen mobilen Adapter hat, wird der Handler des Adapters für das Ereignis und nicht der eigene Handler des Webparts aufgerufen, wenngleich üblicherweise der Handler des Adapters den des Webparts als Teil seiner Logik aufruft.

4. Die Implementierung in SharePoint Foundation der Handler des Adapters für die vier Ereignisse prüft, ob die aktuelle Seite ein WebPartMobilePage-Objekt ist. Falls ja, ruft die Laufzeit die entsprechende On*ForMobile-Methode auf: OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) oder OnUnloadForMobile(EventArgs).

Weitere Informationen zum mobilen Anpassungssystem von Microsoft ASP.NET 3.5 finden Sie unter Architectural Overview of Adaptive Control Behavior, Browser Definition File Schema (browsers Element) und System.Web.UI.Adapters.ControlAdapter.

SharePoint Foundation Mobile Adaption Framework-Programmierung

Die Entwicklung für das SharePoint Foundation-Framework für mobile Adapter ist tatsächlich einfacher als für das mobile Anpassungssystem von Microsoft ASP.NET 3.5. Wie mit dem Microsoft ASP.NET 3.5-System können Sie für jedes Webpart, auf das der Zugriff über mobile Geräte möglich sein soll, ein mobiles Adaptersteuerelement erstellen. Diesen Adapter ordnen Sie dem Webpart, dessen Rendern angepasst wird, in der Datei compat.browser zu.

Doch die Entwicklung mit dem SharePoint Foundation-Framework unterscheidet sich in einigen Aspekten von der Entwicklung mobiler Adapter mit Microsoft ASP.NET 3.5. Diese Unterschiede sind größtenteils notwendig, um die Konformität mit dem Sicherheitsmodell von SharePoint Foundation sicherzustellen:

• Die Adapterklasse ist von der Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter-Klasse und nicht direkt von der System.Web.UI.Adapters.ControlAdapter-Klasse abgeleitet.

• Die Adapterklasse muss als sicheres Steuerelement registriert sein. Weitere Informationen hierzu finden Sie unter Arbeiten mit Web.config-Dateien.

• Sie überschreiben nicht die Render(HtmlTextWriter)-Methode, die von der ControlAdapter-Klasse geerbt wird. Stattdessen überschreiben Sie mindestens eine dieser Methoden: CreateControlsForSummaryView() und CreateControlsForDetailView().

• Sie überschreiben nicht die Methoden OnLoad(EventArgs), OnInit(EventArgs), OnPreRender(EventArgs) und OnUnload(EventArgs), die Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter von ControlAdapter erbt. Stattdessen überschreiben Sie, wenn Sie zusätzliche Logik für eines dieser Ereignisse benötigen, eine oder mehrere der speziellen sicheren SharePoint-Ersatzmethoden von Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter: OnLoadForMobile(EventArgs), OnInitForMobile(EventArgs), OnPreRenderForMobile(EventArgs) und OnUnloadForMobile(EventArgs).

  Wichtig
  Wichtige Anmerkungen zum Überschreiben dieser vier Methoden finden Sie in den entsprechenden Referenzthemen.

• Die für mobile Geräte zugänglichen Webpartseiten sind Objekte der WebPartMobilePage-Klasse. Sie erstellen diese Objekte jedoch nicht. Wenn ein Benutzer eines mobilen Geräts zu einer Webpartseite navigiert, die für mobile Geräte angepasste Webparts enthält, wird zur Laufzeit ein WebPartMobilePage-Objekt erstellt und an das mobile Gerät zurückgegeben.

• Jede Webpartseite, die für mobile Geräte angepasste Webparts enthält, hat eine entsprechende Anwendungsseite, auf der die Sichtbarkeit und Reihenfolge der angepassten Webparts festgelegt werden kann. Diese Seiten sind Objekte vom Typ WebPartMobileSettingPage und werden ebenfalls zur Laufzeit erstellt, wenn ein Benutzer zu einem Objekt navigiert (meist durch Klicken auf eine Schaltfläche auf dem Menüband auf einer Webpartseite).

Siehe auch

Referenz

System.Web.UI.Adapters.ControlAdapter

Microsoft.SharePoint.WebPartPages.WebPartMobileAdapter

Konzepte

Arbeiten mit Web.config-Dateien

Weitere Ressourcen

Architectural Overview of Adaptive Control Behavior

Browser Definition File Schema (browsers Element)