Globale Attribute für HTML-Renderingelemente

Letzte Änderung: Freitag, 26. März 2010

Gilt für: SharePoint Foundation 2010

Das Ansichtsschema von Einführung in CAML (Collaborative Application Markup Language) stellt mehrere universelle Attribute bereit, mit denen ein CAML-Renderingelement beschrieben werden kann. Diese Attribute können in standardmäßigen und speziellen Elementen im View-Schema implementiert werden.

Hinweis
Das Vorhandensein eines dieser Attribute impliziert, dass es TRUE ist (HTMLEncode kann beispielsweise nicht auf FALSE festgelegt werden).

Beispiele für universelle Attribute:

• AutoHyperLink - Bei TRUE wird das Rendering für Zeichenfolgen geprüft, die wie Hyperlinks aussehen (z. B. www.microsoft.com). Wenn diese Zeichenfolge gefunden wird, wird automatisch ein entsprechendes <A>-Tag um den Text eingefügt, sodass der Benutzer dem Hyperlink folgen kann. HTMLEncode wird als TRUE vorausgesetzt, wenn AutoHyperLink auf TRUE festgelegt ist.

• AutoNewLine - Bei TRUE werden <BR>-Tags in den Textstream eingefügt, und mehrere Leerzeichen werden durch ein geschütztes Leerzeichen (&nbsp;) ersetzt. AutoHyperLink muss auf TRUE festgelegt sein, damit dieses Attribut wirksam wird. HTMLEncode wird als TRUE vorausgesetzt, wenn AutoNewLine auf TRUE festgelegt ist.

• Default - Falls der übergreifende Text leer ist, wird stattdessen dieser Text gerendert. Ein Beispiel: <ows:XML><ListProperty Select="Description" Default="Diese Liste hat keine Beschreibung"/></ows:XML>. Im vorherigen Beispiel wird der Standardtext gerendert, wenn keine Beschreibung für die betreffende Liste verfügbar ist.

• ExpandXML - Bei TRUE wird der gerenderte Inhalt überprüft und für einen weiteren Durchgang an den CAML-Interpreter gesendet. Dadurch kann CAML CAML-Daten rendern.

• HTMLEncode - Bei TRUE werden eingebettete Zeichen so konvertiert, dass sie als Text im Browser angezeigt werden. Dies bedeutet, dass alle Zeichen, die mit HTML-Tags verwechselt werden könnten, in Entitäten wie "&gt;" an Stelle von ">" konvertiert werden.

• StripWS - Bei TRUE werden die Leerzeichen vom Anfang und Ende eines Elements entfernt. Ein Beispiel: <ows:XML StripWS="TRUE"> Microsoft </ows:XML> wird als "Microsoft" ohne die umschließenden Leerzeichen gerendert.

• URLEncode - Bei TRUE werden Sonderzeichen wie Leerzeichen in das UTF-8-Format konvertiert (ein Beispiel: %c3%ab für das Zeichen ë).

• URLEncodeAsURL - Ähnlich wie URLEncode. Es wird jedoch vorausgesetzt, dass es sich bei dem verschlüsselten Element um eine Pfadkomponente einer URL handelt. Ein Beispiel: <ows:XML URLEncodeAsURL="TRUE">SharePoint Web Site</ows:XML> wird als SharePoint%20Web%20Site gerendert. Dieses Attribut führt im Gegensatz zu URLEncode keine Verschlüsselung des Schrägstrichs ("/") aus.