LookupColumn-Element (Ansicht)
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
Zahlreiche
Vorkommen
- Minimum: 0
- Maximum: Unbegrenzt (1 in Expr1, Expr2 und UrlBaseName)
HinwBemerkungeneise
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>