Freigeben über

LookupColumn-Element (Ansicht)

  • Artikel

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

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>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

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. 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. TRUE , um Sonderzeichen, z. B. Leerzeichen, in UTF-8-Format in Anführungszeichen zu konvertieren, %c3%ab z. B. für zeichen ë.
URLEncodeAsURL
Optionaler Boolean-Wert. Wie URLEncode, aber TRUE , um anzugeben, dass die zu codierende Zeichenfolge eine Pfadkomponente einer URL ist und nicht, um den Schrägstrich zu codieren (/).

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Zahlreich

Vorkommen

Hinweise

Im Fall eines Suchfelds namens LookupTitle, das auf den Titel von Element 1 in einer Ankündigungsliste verweist, <LookupColumn Name="LookupTitle"/> würde "Erste Schritte mit SharePoint Foundation!" rendern, während <Column Name="LookupTitle"/> "1" gerendert würde.

Daher verwenden Sie in den meisten Situationen, in denen Nachschlagefelder enthalten sind, das LookupColumn-Element anstelle des Column-Elements . Das Column-Element kann nur verwendet werden, wenn Sie einen unformatierten Verweis auf die ID des Elements in der Zielliste benötigen, z. B. zum Erstellen eines eigenen Links zum Zielelement.

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