Ellipsen und Renderinggrenzwerte

Letzte Änderung: Mittwoch, 20. Januar 2010

Gilt für: SharePoint Foundation 2010

SharePoint Foundation zeigt eine Ellipse im Viewer für das mobile Gerät an, wenn die Textlänge eines Felds einen in der Datei web.config für mobile Geräte festgelegten Grenzwert überschreitet (im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\MOBILE). In Bearbeitungsformularen für mobile Geräte deaktiviert SharePoint Foundation für Elemente, die sehr viele Daten enthalten, die Feldbearbeitung pro Feldtyp, um Datenverlust zu vermeiden, wenn die Inhalte einen angegebenen Grenzwert überschreiten. In beiden Fällen bestimmen Renderinggrenzwerte für mobile Geräte, was auf dem mobilen Gerät angezeigt wird.

Renderinggrenzwerte definieren nicht nur Textlängengrenzwerte für das in mobilen Steuerelementen verwendete Rendering von Ellipsen, sondern auch die Anzahl von Optionen, die in den Steuerelementen angezeigt werden. Eine Liste der Renderinggrenzwerte und deren Standardwerte finden Sie in der Tabelle am Ende dieses Themas.

Zwei Methoden zum Konfigurieren von Grenzwerten

Es gibt zwei Methoden, um Renderinggrenzwerte zu bestimmen:

• Farmweite Standardgrenzwerte werden in der Datei web.config für mobile Geräte festgelegt, die bearbeitet werden kann.

• Die Standardgrenzwerte können programmgesteuert auf Websitebasis über die Properties-Eigenschaft von SPWeb überschrieben werden. Änderungen über Webeigenschaften werden nicht von Unterwebsites geerbt.

Ändern der Datei "Web.config" für mobile Geräte

Jede Grenzwerteinstellung in der Datei web.config für mobile Geräte wird als Schlüssel/Wert-Paar im <appSettings>-Abschnitt der Datei dargestellt. Beispielsweise <add key="mobile_webtitlelimit" value="20" />. Falls als Textlängengrenzwert 0 konfiguriert oder kein Eintrag angegeben ist, wird das Rendering von Ellipsen für diesen Schlüssel deaktiviert.

Hinweis
Wenn Sie die web.config file für mobile Geräte ändern, ist dies auf jedem Front-End-Webserver in einer SharePoint Foundation-Bereitstellung erforderlich.

Überschreiben von Standardwerten pro Website mit dem Objektmodell

Für die Anpassung von Renderinggrenzwerten pro Website bestimmt SharePoint Foundation zunächst, ob im Eigenschaftenbehälter (die Properties-Eigenschaft) des SPWeb-Objekts der Parameter für den Renderinggrenzwert gespeichert ist. Falls dies der Fall ist, gibt der im Eigenschaftenbehälter gespeicherte Wert den Renderinggrenzwert an. Andernfalls gibt der in der Datei web.config gespeicherte Wert den Renderinggrenzwert an. Deshalb überschreiben Eigenschaftenbehältereinstellungen für eine bestimmte Website die Farmeinstellungen in der Datei web.config für das mobile Gerät.

Wenn Sie den Renderinggrenzwert für ein mobiles Steuerelement ändern möchten, fügen Sie dem Eigenschaftenbehälterobjekt (SPPropertyBag) in der Properties-Eigenschaft eine Eigenschaft hinzu. Im folgenden Beispiel wird das Ändern des Renderinggrenzwerts für Listentitel einer bestimmten Website in 256 Zeichen veranschaulicht.

SPWeb webSite = SPContext.Current.Site.AllWebs["MyWebSite"];
webSite.Properties["mobile_listtitlelimit"] = "256";
webSite.Properties.Update();

Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MyWebSite")
webSite.Properties("mobile_listtitlelimit") = "256"
webSite.Properties.Update()

Für dieses Beispiel sind using-Direktiven (Imports in Visual Basic) für die Namespaces Microsoft.SharePoint und Microsoft.SharePoint.Utilities erforderlich.

Renderinggrenzwerte

In der folgenden Tabelle werden die Parameter für die Renderinggrenzwerte beschrieben, die auf mobilen Seiten verwendet werden, und die Standardhöchstwerte angegeben. Die Maßeinheit sind Zeichen, unabhängig davon, ob es sich um Zeichen halber Breite oder Zeichen normaler Breite handelt.