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.

Name	Beschreibung	Wert
Basisrenderinggrenzwert
mobile_basetextlengthlimit	Basisgrenzwert für die Textlänge	1024
Systemrenderinggrenzwerte
mobile_peoplesearchresultlimit	Grenzwert für die Anzahl von Elementen, die bei einer Personensuche zurückgegeben werden	50
mobile_maximumimagesize_kilobyte	Grenzwert für die Größe von Bildern in KB	100
mobile_enablelimitationondispform	Kennzeichen für das Rendering von Ellipsen im Anzeigeformular	FALSE
mobile_fieldnumberlimitforinputform	Grenzwert für die Anzahl anzuzeigender Felder in neuen und bearbeiteten Formularen	100
mobile_fieldtitlelimit	Grenzwert für den Titel der Felder in Formularen	1024
mobile_itemtitlelimit	Grenzwert für den Elementtitel, der in Formularen angezeigt wird	1024
mobile_listtitlelimit	Grenzwert für den Listentitel in Listenansichten	1024
mobile_viewitemnumberlimit	Grenzwert für die Anzahl anzuzeigender Elemente in Listenansichten	1000
mobile_viewnumberlimit	Grenzwert für die Anzahl anzuzeigender Ansichten in der Ansicht-Dropdownliste	20
mobile_viewtitlelimit	Grenzwert für die Länge von Ansichtsnamen in der Ansicht-Dropdownauswahl	1024
mobile_webtitlelimit	Grenzwert für die Länge des Websitetitels, der auf der obersten Seite der Website angezeigt wird	1024
Feldbezogene Grenzwerte
mobile_attachmentsfieldnumberlimit	Grenzwert für die Anzahl anzuzeigender Anlagen	20
mobile_attachmentsfieldtextlimit	Grenzwert für den Dateinamen einer einzelnen Anlage	1024
mobile_calculatedfieldtextlimit	Grenzwert für die Länge des Feldwerts für berechnete Felder	1024
mobile_choicefieldoptionnumberlimit	Grenzwert für die Anzahl anzuzeigender Optionen in neuen und bearbeiteten Formularen für ein Auswahlfeld	20
mobile_choicefieldoptiontextlimit	Grenzwert für den Namen von Personen in neuen und bearbeiteten Formularen für ein Auswahlfeld	1024
mobile_fieldtextlimitforview	Grenzwert für die Länge einzelner Feldwerte in Listenansichten	1024
mobile_filefieldtextlimit	Grenzwert für die Länge des Feldwerts für Dateifelder	1024
mobile_lookupfieldoptionnumberlimit	Grenzwert für die Anzahl anzuzeigender Optionen in neuen und bearbeiteten Formularen für ein Nachschlagefeld	20
mobile_lookupfieldoptiontextlimit	Grenzwert für den Namen einzelner Optionen in neuen und bearbeiteten Formularen für ein Nachschlagefeld	1024
mobile_multichoice_displaylimitforselectedchoices	Grenzwert für die Anzahl ausgewählter Auswahlmöglichkeiten in einem Feld mit Mehrfachauswahl, die in Listenansichten und Elementanzeigeformularen angezeigt werden sollen	20
mobile_multilinetextfieldtextlimit	Grenzwert für die Länge des Feldwerts für mehrzeilige Textfelder	2048
mobile_multilookup_displaylimitforselectedlookups	Grenzwert für die Anzahl ausgewählter Nachschlagewerte in einem mehrwertigen Nachschlagefeld, die in Listenansichten und Elementanzeigeformularen angezeigt werden sollen	20
mobile_multiuser_displaylimitforselectedusers	Grenzwert für die Anzahl ausgewählter Benutzer in einem Feld mit mehreren Benutzern, die in Listenansichten und Elementanzeigeformularen angezeigt werden sollen	100
mobile_singlelinetextfieldtextlimit	Grenzwert für die Länge des Feldwerts für einzeilige Textfelder	1024
mobile_urlfieldtextlimit	Grenzwert für die Textlänge eines URL-Felds (die URL selbst wird nicht angezeigt und nicht abgeschnitten)	1024
mobile_userfieldoptionnumberlimit	Grenzwert für die Anzahl anzuzeigender Optionen in neuen und bearbeiteten Formularen für ein Benutzerfeld	20
mobile_userfieldoptiontextlimit	Grenzwert für die Länge einzelner Optionen für ein Benutzerfeld	1024