LookupColumn-Element (Ansicht)

Artikel
09/24/2014

Letzte Änderung: Donnerstag, 15. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Die Funktionsweise ähnelt dem Column-Element; das Element ist jedoch nur gültig, wenn es auf ein Lookup-Feld verweist. Der einzige Unterschied zwischen dem Column- und dem LookupColumn-Element für Lookup-Felder besteht darin, dass LookupColumn den Rohwert der Spalte aus der fremden Liste abruft, während Column den Rohwert der Spalte in der lokalen Liste abruft.

<LookupColumn
    HTMLEncode = "TRUE" | "FALSE"    IncludeVersions = "TRUE" | "FALSE" 
    Name = "Text"
    ShowField = "Text"
    StripWS = "TRUE" | "FALSE"
    URLEncode = "TRUE" | "FALSE"
    URLEncodeAsURL = "TRUE" | "FALSE">
</LookupColumn>

Attribute

Attribut	Beschreibung
HTMLEncode	Optionaler Boolean-Wert. Ist TRUE, um eingebettete Zeichen zu konvertieren, sodass sie als Text im Browser angezeigt werden. Mit anderen Worten, Zeichen, die mit HTML-Tags verwechselt werden können, werden in Entitäten konvertiert.
IncludeVersions	Optionaler Boolean-Wert.
Name	Erforderlicher Text-Wert. Gibt den Namen der Suchspalte an. Ermöglicht es durch Angabe einer ID, das LookupColumn-Element außerhalb des Feldrenderingkontextes zu verwenden.
ShowField	Optionaler Text-Wert. Gibt das Feld an, das in der Liste angezeigt werden soll, auf die im Lookup-Feld verwiesen wird. Wird dieses Attribut nicht angegeben, wird standardmäßig der Wert angezeigt, der im Title-Feld enthalten ist.
StripWS	Optionaler Boolean-Wert. Ist TRUE, um Leerzeichen vom Anfang und Ende des vom Element zurückgegebenen Werts zu entfernen.
URLEncode	Optionaler Boolean-Wert. Ist TRUE, um Sonderzeichen wie z. B. Leerzeichen in das UTF-8-Format zu konvertieren, beispielsweise %c3%ab für das Zeichen ë.
URLEncodeAsURL	Optionaler Boolean-Wert. Ähnelt URLEncode, aber ist TRUE, um anzugeben, dass die zu codierende Zeichenfolge eine Pfadkomponente einer URL ist und der Schrägstrich ("/") nicht codiert werden soll.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Zahlreiche

Vorkommen

Minimum: 0

Maximum: Unbegrenzt (1 in Expr1, Expr2 und UrlBaseName)

Hinweise

Im Falle eines Lookup-Felds mit dem Namen LookupTitle, das auf den Titel von Element 1 in einer Ankündigungsliste verweist, würde <LookupColumn Name="LookupTitle"/> "Erste Schritte mit <SharePoint Foundation!" rendern, während <Column Name="LookupTitle"/> "1" rendern würde. Demzufolge sollten Sie in den meisten Situationen, in denen Lookup-Felder zum Einsatz kommen, das LookupColumn-Element anstelle des Column-Elements verwenden. Das Column-Element sollte nur dann verwendet werden, wenn Sie einen Rohverweis auf die ID des Elements in der Zielliste benötigen, z. B. um einen eigenen Link zum Zielelement zu bilden.

Beispiel

Im folgenden Beispiel wird das LookupColumn-Element verwendet, um einen Wert zurückzugeben, der beim Erstellen einer vollständigen URL für eine Seite auf dem Server verwendet wird.

<HTML><![CDATA[ <a href="  ]]></HTML>
<HttpHost URLEncodeAsURL="TRUE" />
<LookupColumn URLEncodeAsURL="TRUE" />
<HTML><![CDATA[ ">  ]]></HTML>

Siehe auch

Referenz

Column-Element (Ansicht)

Freigeben über